Using the Viable States macro

Owned by Hagen Admin (Unlicensed)
Last updated: 27. Jul 2020

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.

  1. In edit mode the macro Viable States can be found by using the function "Insert additional content" → "Other macros".
  2. 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.
  3. A status is always defined as follows and separated by a comma:
    1. Name of the status (e.g. Approved)
    2. Status color (e.g. green)
    3. 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.