⚡ Atlassian Confluence Cloud • Build v3.37.0

Easy Project Dashboard

Complete user manual, setup instructions, and data management guide for interactive portfolio timelines and Gantt delivery roadmaps.

1 Adding the Macro to a Confluence Page

Easy Project Dashboard is an editor macro designed to provide portfolio transparency and delivery roadmaps directly on your team's Confluence pages.

  1. Open your Confluence page in Edit mode.
  2. Type /Easy Project Dashboard (or shortcut /dashboard) in the editor canvas.
  3. Select Easy Project Dashboard from the insert suggestion list.
  4. Publish or preview the page.
💡 Instant First-Time Preview
When inserted on a new page, the dashboard immediately renders a rich, pre-bundled sample dataset (with realistic squads, dates, sizes, and RAG status colors). You can interact with and explore all features immediately without requiring any upfront setup!

2 Customizing Titles & Dashboard Labels

Page editors can customize headers to align with team nomenclature:

  1. Click the ⚙️ Settings button in the top-right toolbar of the dashboard.
  2. In the Dashboard Details (Page Default) section, configure:
    • Dashboard Title: Customize the main heading (e.g. "Q4 Mobile & Platform Roadmap").
    • Description / Subtitle: Optional narrative for program goals, OKRs, or sprint milestones.
    • First Column Title: Rename the sidebar category. If your team doesn't organize by "Project Manager", rename it to Squad, Stream, Tech Lead, or Initiative.

3 Preparing & Uploading Your Project Data

You can upload your own roadmap dataset using any standard CSV or JSON file:

Downloading Templates

Inside the ⚙️ Settings panel, click:

Required Data Columns

Column Name Required Description & Accepted Formats Example
Project Manager Yes The owner, stream, squad, or team lead. Jordan Lee, Core API Squad
Project Name Yes Initiative title or deliverable summary. Checkout Flow Redesign
Start Date Yes Kickoff date. Supports DD-MMM-YYYY, YYYY-MM-DD, DD/MM/YYYY, or Excel serials. 15-Jul-2026, 2026-07-15
End/Due Date Yes Target completion or release milestone date. 30-Nov-2026, 2026-11-30
RAG Status Optional Delivery status color badge:
GREEN AMBER RED
COMPLETED TODO
GREEN, AMBER, TODO
Size Optional T-shirt estimation that drives timeline bar thickness: S, M, L, XL. M (default: S)
URL Optional Hyperlink to Jira epic, issue, PR, or Confluence specification page. https://site.atlassian.net/browse/PROJ-101

Sample CSV Snippet

Project Manager,Project Name,Start Date,End/Due Date,RAG Status,Size,URL
Pat Robinson,Cloud Architecture Migration,01-Jul-2026,30-Sep-2026,GREEN,M,https://example.com/proj-1
Dana Scott,Payment Gateway Modernization,10-Aug-2026,31-Oct-2026,AMBER,L,https://example.com/proj-2
Sam Taylor,Automated Security Compliance,16-Jul-2026,15-Sep-2026,COMPLETED,S,https://example.com/proj-3
  1. In ⚙️ Settings, click 📁 Upload CSV / JSON.
  2. Select your spreadsheet file. The dashboard validates the records and plots the entire Gantt schedule instantly!

4 Setting the Page Default View

As the page creator or project coordinator, you can curate how the dashboard appears to all viewers:

  1. Adjust the display settings:
    • Density: Choose Super Compact (high-density bird's eye), Compact, or Full Info.
    • Colour By: Set bar coloring to Status to PM (hybrid gradient), Project Manager, or Status.
    • Theme: Select Confluence Light, Confluence Dark, or Night Indigo (automatically honors your Confluence color mode by default).
    • Timeline Zoom: Use +, −, or Fit to frame your delivery quarters.
    • Pre-filters: Select any specific PMs, sizes, or statuses you want enabled by default.
  2. In ⚙️ Settings, click 📌 Save View as Page Default.
  3. Whenever team members or stakeholders open the Confluence page, it loads directly in your curated configuration!

5 Viewer Features & Day-to-Day Navigation

Every teammate with view access to the Confluence page can explore the timeline interactively without altering the saved default data:

6 Storage Architecture & Automated Cleanup

Strict Macro Isolation

Each dashboard macro instance receives a unique UUID generated by Confluence. Data and custom view configurations are strictly bound to that specific macro instance. If a macro is removed or replaced, new dashboards will never inherit stale or contaminated data.

Automated Page Lifecycle Cleanup

When a Confluence page containing dashboards is moved to trash or permanently deleted, the app's Forge backend trigger (onPageDeleted) automatically cascades and purges all associated dataset and configuration keys from Atlassian Cloud Storage. Your customer tenant remains completely clean and compliant.