Dynamic Visibility Overview
What Is Conditional Visibility?
Conditional visibility macros let you show or hide sections of content based on who is viewing the page. A single page can display different content to different audiences - admins see internal notes, guests see the public version, and managers see the compensation table.
Two Macros
| Macro | Behavior |
|---|---|
| Conditional Show | Content is hidden by default; shown only to users who match the condition |
| Conditional Hide | Content is visible by default; hidden only for users who match the condition |
Condition Types
| Condition | Description |
|---|---|
| Confluence User | Show/hide for specific individual Confluence users |
| Confluence Group | Show/hide based on Confluence group membership (e.g., confluence-admins) |
You can select multiple users and/or groups in one macro. Use the Match using setting to control whether the viewer must match Any (at least one) or All of the selected conditions.
Common Patterns
Pattern 1 - Admin-only notes: Conditional Show, group = confluence-admins.
Pattern 2 - Manager-only HR content: Conditional Show, group = hr-managers.
Important Warning
Conditional visibility is a UI control, not a security boundary.
Users with page-read permission can still access all page content via the Confluence REST API, regardless of Conditional Show/Hide settings. These macros change what is displayed in the browser - they do not change who has access to the underlying content.
For truly sensitive content, use Confluence Page Restrictions to limit read access at the page level.