Insert Handy Status

Once you have one or more status sets created in your Confluence instance, you can insert a Handy Status macro and interactively switch between statuses of the selected status set.

  1. Go to the edit mode.
  2. Insert the Handy Status macro from the editor toolbar (click  Insert more content     >  Handy Status) or by typing { > Handy Status. You can also use a hotkey (Ctrl+Alt+S).
  3. Select the proper status set and status.
  4. Click Insert.

Change Handy Status

In the page view mode

  1. Click the status when viewing the page. All the statuses from the selected status set will be shown. 
  2. Select a new status.

(info) You can't change the status set for the status in the page view mode. This can be done in the page edit mode only.

In the edit mode

  1. Click the status you want to change. 
  2. Choose the required set and/or status.
  3. Save the page.

Link statuses to page labels

This feature is available starting from Handy Macros 1.8.0. Mappings are bidirectional starting from Handy Macros 1.9.0.

Each Handy Status can be linked to the page label. This label will be updated every time you switch the status. You can also use prefixes for labels for better traceability.

  1. Go to the edit mode.
  2. Click the status which you want to link to the page label.
  3. Click Edit.
  4. Check Synchronize the page label with status.
  5. Add Label prefix if needed.
  6. Click Save.

View Handy Status History

Inline status history is available starting from Handy Macros 1.5.0.

Display of the status creator is available from Handy Macros 1.7.0.

In the page view mode

  1. Hover over the status.
  2. See the date, time, author, and status value changes.

In the page history

  1. Navigate to the menu > Page history.
  2. Choose two versions of the page to which you want to view the status changes.
  3. Click Compare selected versions.
  4. All status changes will be visible alongside other differences between page versions. 

Search for statuses through the pages

You can search for specific statuses on Confluence pages by status name. This feature works both with native statuses and Handy Statuses.

This feature is available starting from Handy Macros 1.7.0.

For the correct status lookup on Confluence pages, please perform the full re-indexation of Confluence content. 

  1. Navigate to the Search bar.
  2. Click Advanced.
  3. Click Add a filter.
  4. Choose Status.
  5. Specify the status to look up for pages that contain this status.

Delete a status or a status set

You can delete a separate status from any set or the whole status set. It can be done at any level (depending on the user's Confluence permissions).

  1. Navigate to Settings >Apps>Handy Macros.
  2. Locate the status or status set that you want to delete.
  3. Click Delete.
  4. Submit your action by clicking Remove.

Deleted statuses or sets aren't visible for users or admins, but their values are kept in our database. This is done for their correct appearance on those pages where they were used before. our Confluence pages will look normal even if the status is already deleted.