Hide If
The Visibility - Hide if macro hides the content in its body from users who meet specified conditions. The macro content remains visible to 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 Hide if macro can hide 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 hide large content, consider splitting it into sections using multiple Hide if macros to prevent performance issues.
The macro hides its content only 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
When inserting or editing the Hide if macro, the macro editor lets you configure its parameters.
Macro parameters
The parameters in the macro editor let you configure the conditions for hiding 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 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 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 the page viewer. Can be:
|
Macro content editor
In page edit mode, within the Hide if macro body, you can enter the content you want to conditionally hide.
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 Hide if macro parameters.
Related pages