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. Confirm the group you need already exists - you'll search for and select it by name inside the macro, so no need to copy the exact spelling
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. Type / → Conditional Show → insert it
3. 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
4. Save the macro
5. In the macro body, enter the content you want to show.
6. Publish the page.
7. 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. Open the page in edit mode
2. Type / → Conditional Hide → insert it
3. In the config panel:
   • Under Groups, search and select the Confluence group who should not see this content
   • Optionally add individual users under Users
   • Set Match using to Any or All as needed
4. Save the macro
5. In the macro body, enter the content you want to hide.
6. Publish the page.
7. Test: log in as a group member (hidden) and a non-member (visible)

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

• Correct group selected in the macro's group picker
• 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