User Guide
How to: Create a Stakeholder Content Dashboard
A workflow for building a Confluence page that shows executives and PMO leaders a live overview of documentation health - page counts, contributor activity, content growth trends, and top contributors.
Dashboard Structure
Content Dashboard Page
├── Row 1: KPI tiles (Total Pages, New This Month, Stale Pages)
├── Row 2: Pie chart (Content by type) + Bar chart (Top contributors)
└── Row 3: Table (Recently updated pages)
Step 1 - Total Pages KPI
- Insert the Reports macro → Header: Data Source = Spaces, select your space, Report Type = Table
- Left Panel: load version expansion
- Right Panel → Columns: add Page Title (Link type)
- Set Result Limit to 1000
- Save. This table is your base - you'll convert it to a chart next
→ For a count-only tile, use the Charts report type with Chart Type = Pie, Group By = Space (shows total in one slice).
Step 2 - Content Type Breakdown Pie Chart
- Insert a second Reports macro
- Data Source: Custom CQL →
space = "KEY" AND type in (page, blogpost) - Report Type: Charts → Chart Type: Pie → Group By: Content Type
- Save - shows the mix of pages vs blog posts
Step 3 - Top Contributors Bar Chart
- Insert another Reports macro
- Data Source: Custom CQL →
space = "KEY" AND type = page AND lastmodified >= now("-30d") - Left Panel: load version expansion
- Report Type: Charts → Chart Type: Bar → Group By: Last Author (version.by.displayName)
- Save - shows who updated the most pages this month
Step 4 - Recently Updated Pages Table
- Insert a final Reports macro
- Data Source: Custom CQL →
space = "KEY" AND type = page ORDER BY lastmodified DESC - Left Panel: load version expansion
- Report Type: Table
- Columns: Page Title (Link), Last Modified, Last Author, Created By
- Result Limit: 20 (most recent 20 pages)
- Save
Step 5 - Arrange and Publish
- Use Confluence columns layout (two- or three-column) to arrange the macros side by side
- Add headings above each report section: "Content Overview", "Top Contributors", "Recent Updates"
- Publish the page
The page is now a live dashboard - all reports update automatically when the page is viewed.
→ Templates - use the Top Contributors and Recently Updated Pages pre-built templates instead of configuring from scratch