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.
- Open your Confluence page in Edit mode.
- Type
/Easy Project Dashboard(or shortcut/dashboard) in the editor canvas. - Select Easy Project Dashboard from the insert suggestion list.
- Publish or preview the page.
2 Customizing Titles & Dashboard Labels
Page editors can customize headers to align with team nomenclature:
- Click the ⚙️ Settings button in the top-right toolbar of the dashboard.
- 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:
- 📥 Sample CSV: Best for editing in Microsoft Excel, Google Sheets, or Apple Numbers.
- 📥 Sample JSON: Ideal for automated Jira REST exports or custom CI/CD pipelines.
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
- In ⚙️ Settings, click 📁 Upload CSV / JSON.
- 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:
- 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.
- In ⚙️ Settings, click 📌 Save View as Page Default.
- 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:
- 🔍 Instant Search: Type in the search box to find specific projects or leads in real time. Click ✕ to clear.
- Interactive Details Cards: Hover your mouse over any schedule bar to expand full project details, duration, start/due dates, and click-through URLs. Hovering smoothly pushes down neighboring lanes without flickering.
- Multi-Select Filters:
- Filter PMs: Focus on one squad or isolate multiple streams.
- Size Filter: Focus on major initiatives (
XL/L) or tactical tasks. - Status Filter: Isolate at-risk (
RED/AMBER) deliverables for standups.
- ↺ Reset Filter: Quickly restores all filters, search text, and zoom levels back to the page default.
- Template Access: Viewers can also download sample CSV/JSON templates from ⚙️ Settings > Sample Templates.
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.