Getting Started

Quick Start Guide

Who This App Is For

  • Confluence Space Admins who want to improve page structure and navigation across their space
  • Page Authors who want richer, more engaging content without custom code
  • Team Leads who want to consolidate scattered documentation into organized, tabbed hubs
  • IT and HR teams who need to show different content to different audiences on the same page

Quick-Start Checklist

  1. Install the app from the Atlassian Marketplace (admin required)
  2. Grant required permissions during install
  3. Open any Confluence page in edit mode
  4. Click the + (Insert) button in the editor toolbar
  5. Search for any macro name (e.g., "Alert", "Buttons")
  6. Configure the macro settings in the panel that appears
  7. Publish the page

Four-Step Path to Your First Tabbed Page

Step 1 - Plan Your Structure

Decide how many tabs you need and what content belongs in each. The most common pattern: one tab per topic, environment, team, or audience.

Step 2 - Choose Your Tab Mapper

  • Tab Parent Content Mapper: Use when tabs should mirror child pages
  • Tab Label Content Mapper: Use when you enter a label and want every page tagged with that label to appear as its own separate tab
  • Tab Confluence Page Mapper: Use when you want to hand-pick exactly which pages appear as tabs
  • Create Custom Tabs: Use when content lives directly on the page, not in separate child pages

Step 3 - Insert and Configure

Insert the tab mapper macro directly on the page (type "/" → search the macro name). Configure the mapper settings (parent page, label name, or page list) in the config panel.

Step 4 - Enrich with Formatting Macros

Add Alert macros for warnings, Buttons for CTAs, Background for section separation, and Status badges for current state. Publish when ready.