Using the Viable States macro
After reading the Quick start guide Viable States we now can go on a deep dive using the Viable States macro.
Using Viable States for Confluence
Add the Viable States macro to a Confluence page. Please follow the instructions of Atlassian's official documentation for macros (Confluence 7.6).
The Viable States macro allows a user to make a selection (status) in the form of a dropdown with a colored lozenge (rounded box) and thus to make a visual identification.
At the same time a unique label assigned to the status is set on the page. This enables a search for all pages with the same status.
Conversely, adding the corresponding label sets the corresponding status.
There is a direct connection and therefore an interaction between status and label.
- In edit mode the macro Viable States can be found by using the function "Insert additional content" → "Other macros".
- In the macro parameters, the Default Title and a Default Color can be assigned first. This is used if no status has been selected yet (default status). The selectable statuses can be specified in the States parameter.
- A status is always defined as follows and separated by a comma:
- Name of the status (e.g. Approved)
- Status color (e.g. green)
- Label (e.g. status-approved)
Use-cases
Viable States for Confluence can be used in various use-cases. Basically customers use it to change the status and the corresponding label on a page. Have a look at our Use-Cases page to read about the glorious use-cases of Viable States for Confluence inspired by our customers.