Show If
The Visibility - Show if macro displays the content in its body only to users who meet specified conditions. The macro content remains hidden from all other users.
Starting May 29, 2025, the Visibility app includes an integration with the Comala Document Management app. If a Comala workflow is applied to a page or space, the Show if macro can display its content based on the page’s workflow state. For details, see https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=CDMC&title=Applying%20workflows in the Comala Document Management documentation.
To conditionally display large content, consider splitting it into sections using multiple Show if macros to prevent performance issues.
For users who don’t meet the specified conditions, the macro content is only hidden in Confluence page view mode. It remains visible when editing the page, viewing the page history, receiving email notifications, and more. For protecting sensitive information, consider using the Security & Encryption app.
Macro editor view
When inserting or editing the Show if macro, the macro editor lets you configure the macro parameters.
Macro parameters
The parameters in the macro editor let you configure the conditions for displaying the macro content.
Name | Required | Default Value | Description |
|---|---|---|---|
Match using |
| Any | Defines how to combine the conditions in the macro parameters. Can be:
|
Users |
| N/A | Specifies one or more user names to match against the page viewer. The condition is met if the page viewer matches one of these user names. To add a user, begin entering the user name and select it from the drop-down list. |
Groups |
| N/A | Specifies one or more user groups to match against the page viewer. The condition is met if the page viewer belongs to at least one of these user groups. To add a group, begin entering the group name and select it from the drop-down list. |
Comala Workflow Status |
| N/A | This parameter is available only if the Comala Document Management app is installed and enabled. It requires a Comala workflow to be applied to the page or space. For details, see https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=CDMC&title=Applying%20workflows in the Comala Document Management documentation. Specifies one or more Comala workflow states to match the page state. The condition is met when the page is one of these workflow states. To add a workflow state, select it from the drop-down list. |
Advanced filter > Authentication type |
| None | Specifies the authentication status to match against the page viewer. Can be:
|
Macro content editor
In page edit mode, within the Show if macro body, you can enter the content you want to conditionally display.
Migration notes
Some legacy macro parameters from Confluence Data Center are not supported in Confluence Cloud. For details, see FAQ.
After the migration to Confluence Cloud, the Show legacy field parameters list displays the non-migratable Show if macro parameters.