Custom variables#

Feature availability

  • Available on Self-hosted Enterprise and Pro Cloud plans.
  • You need access to the SMS-iT Workflow instance owner account to create and edit variables. All users can use existing variables.

Available in version 0.225.0 and above.

Custom variables are read-only variables that you can use to store and reuse values in SMS-iT Workflow workflows.

Variables are shared

When you create a variable, it's available to everyone on your SMS-iT Workflow instance.

Create variables#

To create a new variable:

  1. On the Variables page, select Add Variable.
  2. Enter a Key and Value. The maximum key length is 50 characters, and the maximum value length is 220 characters. SMS-iT Workflow limits the characters you can use in the key and value to lowercase and uppercase letters, numbers, and underscores (A-Z, a-z, 0-9, _).
  3. Select Save. The variable is now available for use in all workflows in the SMS-iT Workflow instance.

Edit and delete variables#

To edit or delete a variable:

  1. On the Variables page, hover over the variable you want to change.
  2. Select Edit or Delete.

Use variables in workflows#

You can access variables in the Code node and in expressions:

1
2
// Access a variable
$vars.<variable-name>

All variables are strings.

During workflow execution, SMS-iT Workflow replaces the variables with the variable value. If the variable has no value, SMS-iT Workflow treats its value as undefined. Workflows don't automatically fail in this case.

Variables are read-only. You must use the UI to change the values. If you need to set and access custom data within your workflow, use Workflow static data.