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.

Check out our article with tips for Confluence status management.

Link the status to the page label

Each Handy Status can be linked to the page label. This label will be updated every time you switch the status. It can be configured when you insert Handy Status or edit the Handy Status settings. 

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.

Known issues

If you use Handy Status with the page label connection in a Confluence template, you need to change the value of Handy Status for the corresponding page label to appear.

View Handy Status History

In the page view mode

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

If you use Handy Status in a Confluence template, the template's creator will appear as the initial Handy Status author in the status history. 

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. 

Known issues

You can see no status history in a particular case:

  1. Insert Handy Status on a page.
  2. Change it several times (status history will be present).
  3. Copy this Handy Status and paste it on any Confluence page including the current one.
  4. Change the value of the second Handy Status (status history will be present). 
  5. Revert the page in the Confluence Page history.
  6. The first Handy Status will have no history in the reverted page history.

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.

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 to users or admins, but their values are kept in our database. This is done for their correct appearance on those pages that were used before. Your Confluence pages will look normal even if the status is already deleted.