Variables

Customizable variables in tests

Create custom variables that we will fill in for you. Reference them in the visual locator picker or when prompting the AI agent using $ (e.g. $firstname) by adjusting the enter text step. For each environment you can configure custom variable values.

Example of custom variables, 11/2024

Custom variable referenced in visual locator picker, 11/2024

Do you have an existing variable list? No problem. You can upload it via a json file. The file has to follow this format:

[
  {
    "name": "my_variable",
    "values": ["a", "b", "c"]
  }
]

If you provide several values we will randomly choose one of them per run.

Predefined variables:

We use also several predefined variables that do not show up in the default list, but can be used like the variables above:

• $OCTO_USERNAME: the username you configured for use with your page in the sign up flow or the settings
• $OCTO_PASSWORD: the password you configured for use with your page in the sign up flow or in the settings
• $OCTO_URL: the URL of your page
• $OCTO_STABLE_UUID: a random combination of letters and numbers that will be consistent through multiple references across a single run, but different if you run the agent again - full uuid of 36 characters
• $OCTO_STABLE_UUID_SHORT: a random combination of letters and numbers that will be consistent through multiple references across a single run, but different if you run the agent again - maximum length of 8 characters.
• $OCTO_STABLE_RANDOM_CHARACTERS: eight random lowercase letters that will be consistent through multiple references across a single run, but different if you run the agent again.
• $OCTO_TOTP: 2-Factor Authentication code if you require if for the login. Find out more about 2-FA enrollment
• $OCTO_EMAIL: email address for email flows (e.g. 2FA) email flows.
• $OCTO_EMAIL_DOMAIN: domain of the email address for email flows (e.g. 2FA) email flows.
• $OCTO_EMAIL_PREFIX: prefix of the email address for email flows (e.g. 2FA) email flows.

Dynamic variables:

In addition to the predefined variables, we also support dynamic variables that are generated during the test execution. Dynamic variables are noted as $$varname and will be replaced by their current value.

There is also one predefined dynamic variable that can be used:

• $$OCTO_CLIPBOARD: will template the clipboard content at runtime with the (text) value of the clipboard.

Names of dynamic variables are case sensitive and must start with a letter or underscore, followed by any number of letters, digits, or underscores. A dynamic variable is created by an extract step that extracts a value from a web page using a locator and assigning it to a dynamic variable.

Example of extract step, 03/2025

Additionally, you can extract an attribute value from an element using the extract value step. The new drop down option attribute allows you to extract the value of an attribute from an element.

Example of extract step with attribute, 06/2025