How to: Create Role-Based Content Visibility

A workflow for showing or hiding specific content sections based on who is viewing the page - without creating separate pages for each audience.

→ Conditional Show Guide · Conditional Hide Guide

When to Use This

Step 1 - Identify Your Groups

1. Go to Confluence Admin → Groups (or Site Admin → Groups for cloud)
2. Note the exact group name - Conditional macros are case-sensitive
3. If a group doesn't exist, create it in Confluence Admin and assign the right users

Step 2 - Wrap Content with Conditional Show

To show content only to a specific group:

1. Open the page in edit mode
2. Select the content block you want to restrict
3. Type / → Conditional Show → insert it (wraps the selected content)
4. In the config panel:
   • Under Groups, search and select the Confluence group who should see this content
   • Optionally add individual users under Users
   • Set Match using to Any or All as needed
5. Save the macro and Publish the page
6. Test: log in as a group member (visible) and a non-member (hidden)

Step 3 - Wrap Content with Conditional Hide

To hide content from a specific group:

1. Select the content to hide
2. Type / → Conditional Hide → insert it
3. In the config panel, under Groups, search and select the group to hide from
4. Publish and test

Step 4 - Stack Multiple Conditions on the Same Page

You can place multiple Conditional Show macros side by side to show different content to different audiences on the same page:

[Conditional Show - Group: engineering-team]
  → Engineering-specific setup steps
[Conditional Show - Group: product-team]
  → Product team workflow steps
[Content with no conditional macro]
  → Visible to everyone

Each block is independent - users in multiple groups see all content that matches any of their groups.

Verification Checklist

• Group name matches exactly (copy-paste from Confluence Admin)
• Tested with a user IN the target group (content shows correctly)
• Tested with a user NOT in the target group (content is hidden)
• Page published after saving macros