Global Variables
Global variables enable centralized configuration management across your entire Release environment. Unlike release-specific variables, global variables are accessible from any template or release.
You can use variables to manage information that you don't know in advance or that may change.
Global variables can be used in all templates and releases to manage shared information (unlike release variables, which are limited to a single release or template).
Starting from Release 10.1.0, the Password type folder variables are made available to set up connections between Release and other third-party integrated applications.
To create, edit, and delete global variables, select Settings > Global variables from the top menu. The Global variables page is only available to users who have the Edit Global Variables global permission.
Create a Global Variable
Before creating a global variable, ensure you have the Edit Global Variables permission. Follow these steps:
- In the top navigation bar, select Settings.
- Select Global Variables, then click New global variable.
- In the Variable name field, enter a name for the variable.
- In the Label field, enter a label for the variable.
- Select the variable type from the Type list:
- Text: A string of letters or numbers
- List box: A drop-down list of selectable values that can be reordered and can contain duplicates
- Password: A password
- Checkbox: A true or false value (Boolean)
- Number: An integer
- Multi-select list box: A drop-down list to select the multiple values
- Date: A value with formatted time and date
- List: A list of values that can be reordered and can contain duplicates
- Key-value map: A set of keys and corresponding values
- Set: A set of values that cannot be reordered and cannot contain duplicates
Password variables can only be used in password fields, and other types of variables can only be used in non-password fields unless the 'Allow passwords in all fields' is checked on the release properties tab. If selected, passwords can be used in any text field, and the value will be scrubbed from the task output.
- Certain variable types will open additional fields, such as Value provider type or Possible values. Enter the values here if needed.
-
In the Valuefield, enter the value(s) for the variable. To add a value to a list or a set, type the value in the box and press ENTER.
If a global variable does not have a value and it is used in a task, it will appear as a blank space in the task.
-
In the Description field, enter the description of the variable.
-
Click Create to create the variable.
Edit a Global Variable
To edit a global variable, click it. Note that you cannot change the variable's name or type.
If you change the variable's value, planned tasks that use that variable will reflect the new value. Completed, skipped, or failed tasks will reflect the old value.
Use Direct Links to Access Variables
The History page of templates and releases provides direct links that open the Edit Variable modal, making it easy to share and collaborate with team members. Here's what you can do:
-
Access variables using direct links from the Insights > History page of templates and releases, where all variable changes are logged
-
Copy the URL directly from your browser
-
Share variable configurations by sending the link to team members
-
View variable details directly from change history entries by clicking the variable links
-
Get notifications in the History page if a shared link becomes invalid
Delete a Global Variable
To delete a global variable, click Delete under Actions.
If you delete a global variable that is still in use, tasks that use the variable will not be able to start.
How to Use Variable(s) Inside a Variable
In Release version 8.5 and later, you can use variables inside another variable.
For more examples, see Variables in Release.