---
title: "Stiltsoft Handy Status Macro for Confluence"
canonical: "https://support.appfire.com/space/CDML/881493001/Stiltsoft%20Handy%20Status%20Macro%20for%20Confluence"
format: markdown
---
> Macro (aura-html)
## Overview
The **Stiltsoft Handy Status macro** adds and removes the labels on the page.
When you use the [Stiltsoft Handy Status Macro for Confluence app](https://marketplace.atlassian.com/apps/1214971/handy-macros-for-confluence-formatting-and-interactive-ui?tab=overview&hosting=datacenter&utm_source=adaptavist&utm_medium=partner_documentation&utm_campaign=handy-macros-traffic-sources&utm_id=1216111&utm_content=comala_handy) along with a Comala Document Management workflow, configured with a trigger to monitor label addition and page update events, the value of the Stiltsoft Handy Status macro and the workflow status can “synchronize”.
> ℹ️ You need the [Stiltsoft Handy Status macro v3.8.0](https://marketplace.atlassian.com/apps/1214971/handy-macros-for-confluence-formatting-and-interactive-ui?tab=overview&hosting=datacenter&utm_source=adaptavist&utm_medium=partner_documentation&utm_campaign=handy-macros-traffic-sources&utm_id=1216111&utm_content=comala_handy) or above.
## The scenario
> Macro (excerpt)
>
> A user changes the** Stiltsoft Handy Status macro** value for a page, and this automatically changes the Comala Document Management applied workflow state.
> 📝 The **Stiltsoft Handy Status macro** must be linked to the page label in the macro configuration.
When the **Stiltsoft Handy Status** macro **Synchronize the page label with status** option is checked
- the page label is updated every time you switch the status
This is configured when you insert the **Stiltsoft Handy Status macro** or edit the macro settings.
> ℹ️ For further information refer to the **Stiltsoft Handy Status Macro **product documentation - [How to use Stiltsoft Handy Status macro](https://docs.stiltsoft.com/hmfc/server-dc/handy-status/how-to-use-handy-status#HowtouseHandyStatus-Linkthestatustothepagelabel&utm_source=adaptavist&utm_medium=partner_documentation&utm_campaign=handy-macros-traffic-sources&utm_id=1216111&utm_content=comala_handy).
## The solution
In a simple example
- the **Stiltsoft Handy Status** **macro** is synchronized to change the label for the content
- the **Stiltsoft Handy Status macro** is either **no** or **yes**
A Comala Document Management workflow is applied (with two states, **In Progress** and **Approved**). The applied workflow includes three workflow triggers
- two separate triggers change the workflow state when the page label is changed in sync with the **Stiltsoft** **Handy Status macro**
- a third trigger is used to change the page label when the page is edited in the **Approved** state
### Workflow trigger one - Stiltsoft Handy Status macro changed to “no”
This trigger manages the response to a `labeladded` event.
- **Stiltsoft Handy Status** macro is changed to **no**
- the label **no** is added to the page
- a workflow trigger listening for the addition of label **no** sets the state to the **In Progress** state
```
{trigger:labeladded|label=no}
{set-state:In Progress}
{trigger}
```
### Workflow trigger two - Stiltsoft Handy Status macro changed to “yes”
This trigger manages the response to a `labeladded` event.
- **Stiltsoft Handy status** **macro** is changed to **yes**
- the label **yes **is added to the page
- a workflow trigger listening for the addition of the label **yes** sets the state to the **Approved** state
### Workflow trigger three - page update in the Approved state changes page label
This trigger manages the response to a `pageupdated` event in the **Approved** state.
> 📝 An **updated** state transition is not added to the **Approved** state. The transition is managed by this workflow trigger.
The workflow trigger listens for the `pageupdated` event when the workflow is in the **Approved** state.
On this `pageupdated` event, the trigger
- changes the state to the **In Progress** state
- sets the page label to **no**
- removes the page label **yes**
The **Stiltsoft Handy Status macro** is synchronized with the page label so the macro status changes to **no **- the new page label value updated by the workflow trigger.
> 📝 To prevent large numbers of notifications to page watchers, the Stiltsoft Handy macro app marks its content updates as "Minor change" (the same as if you clear the "Notify Watchers" checkbox while editing a page). With [triggers](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563178) and [conditions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694110), we can filter out "Minor Change" [events](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649759655) and then use an [action macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649858941) in the trigger to transition the state.
#### Workflow triggers
```plaintext
{trigger:labeladded|label=no}
{set-state:In Progress}
{trigger}
{trigger:labeladded|label=yes}
{set-state:Approved}
{trigger}
{trigger:pageupdated|state=Approved|isminorchange=true}
{set-state:In Progress}
{set-label:no}
{remove-label:yes}
{trigger}
```
> ℹ️ The `isminorchange` parameter is a [workflow condition](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694110) that can be used in a `pageupdated` or `newsupdated` workflow trigger with the [Stiltsoft Handy Status macro app](https://marketplace.atlassian.com/apps/1214971/handy-macros-for-confluence-formatting-and-interactive-ui?tab=overview&hosting=datacenter&utm_source=adaptavist&utm_medium=partner_documentation&utm_campaign=handy-macros-traffic-sources&utm_id=1216111&utm_content=comala_handy).
## App configuration
There is also a Document Management app setting which may be affected by the **Stiltsoft Handy Status macro** updating content...
| **Setting** | **Where** | **Notes** |
| --- | --- | --- |
| **Page Update Reset Approval** | - [Configuration - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649889951)
- [Configuration - Space Tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649956239) | If enabled, content updates will reset any approvals in an active content review. |
## See also
- [Vendor Website](https://stiltsoft.com/&utm_source=adaptavist&utm_medium=partner_documentation&utm_campaign=handy-macros-traffic-sources&utm_id=1216111&utm_content=comala_handy)
- [Stiltsoft Handy Status Macros for Confluence Data Center - Atlassian Marketplace](https://marketplace.atlassian.com/apps/1214971/handy-macros-for-confluence-formatting-and-interactive-ui?tab=overview&hosting=datacenter&utm_source=adaptavist&utm_medium=partner_documentation&utm_campaign=handy-macros-traffic-sources&utm_id=1216111&utm_content=comala_handy)