What is an options list variable?
An options list variable is a type of variable that can only take one value from a predefined list of options.
Unlike number variables, options list variables are not used for arithmetic calculations. Instead, they are used to store structured text values that can be referenced in templates, conditions.
They are especially useful when you want to make reviews and analysis easier, while also ensuring that only valid values can be selected.
When should I use options list variables?
Use options list variables when:
The value must be selected from a fixed list
The variable will be used in conditions or logic
You want consistent, easy-to-read values
Common examples:
Risk level: Low / Medium / High (instead of 1, 2, 3)
Entity type: Listed / Not Listed (instead of 0 and 1)
How options list variables work
When you create an options list variable, you need to define:
A variable name
A list of options (what users see)
A list of internal values (stored internally and used in integrations)
An default value, marked with a star ⭐
The variable can only take one of the defined options. Any conditions or calculations that reference the variable will respond based on the selected value.
Use Options list variables in conditional logioc
Options list variables are commonly used in conditional logic because they are easier to understand and maintain than numeric values.
This allows you to control content, calculations, or workflows, based on clear, human-readable values.