Get started

Five steps take you from nothing to a value that updates itself across your pages.

#1. Open Variables

In Confluence, open Apps, then Capable, then Variables in the Capable navigation. Inside a space you land on Space variables; elsewhere you land on Global variables. The Getting started section explains the basics and links back to this documentation.

#2. Create a variable

Choose Space variables for a value only this space needs, or Global variables for a value any page can use. Click Create, then fill in:

• Name: how people find it in the catalogue and the picker, for example Product version. Pages show the value, not the name.

• Type: Text, Number, User or Date. You cannot change it later.

• Value: the thing pages will show, for example 4.2.

• Description: optional, and searchable in the catalogue.

Click Create. You need permission to add pages in the space (for global variables, in the Capable Asset Store space).

#3. Show it on a page

Edit a page, put the cursor where the value belongs, type /variable and choose Variable (Capable). In Choose a variable, click the variable you want. The value appears inline, in the same size and colour as the sentence around it.

You can also add a variable without opening the editor: select Variables in the page byline, pick a variable and choose where it goes. See Insert a variable from the byline.

#4. Change the value

Back in the catalogue, click the variable to open its details sidebar, then Edit. Change the value and click Save. Every page that shows the variable displays the new value the next time it loads. The pages get no new version and watchers are not notified.

#5. See where it is used

The sidebar says Used on N pages that you can see. Select it to open Capable Search filtered to every page that shows the variable.

#Related

Start from the task.