Variables and expressions

Create reusable variables that can be referenced in pages and spaces

With variables you can create reusable text that can be conditionally referenced in expressions and conditions for adaptive content.

If you repeat the same name, phrase or version number multiple times within your content, you can create a variable to help keep all those instances in sync and accurate — which is useful if you ever need to update them, or they’re complex and often mistyped.

You can create variables that are scoped to a single page, or a single space.

Create a new variable

To create a new variable, Click the Variables icon in the upper right corner when editing an open change request. This will open the Variables side panel.

You can use the toggle at the top to view and create variables scoped either to the current page you’re on, or all pages within the current space.

Clicking Create a variable will launch a modal where you can give your variable a name and a value.

Click Add variable to save your variable.

You can add variables to a single page or an entire space. When you update the value of a variable, every instance of it will update.

Variable names must start with a letter, and can contain letters, numbers and underscores.

Use variables in your content

Variables can be referenced and used within an expression — which you can insert into your content inline. After inserting an expression, double click it to open the expression editor.

Variables defined under your page are accessible under the page.vars object. Similarly, variables defined across your entire space are accessible under the space.vars object.

You can add variables to your content within expresions. The expression editor offers autocomplete options to help you find the variable you need.

Update a variable

You can update a variable at any point when within a change request. Updating its value will update the value across any expression blocks referencing it. The changed variable will go live to any published site once the change request is merged.