In this post, we’ll look at how to create an awesome roadmap using Confluence’s road mapping planner macro. This roadmap will give your team visibility over their current and future work streams, dependencies on internal or external events and deep linking to the confluence pages documenting the individual projects in detail. Once you have read this post you’ll be on your way to dominating the road-mapping game :).
Let’s have a look at what we’re going to build.
In the last the post we looked at how to create a summary page for a programme of work using the page properties and pages properties report macros.

Below is an image of the summary page that was created.


In this post we’re going to create a visual roadmap for this programme of work and here’s what it’s going to look like. Pretty sweet hey!


Ok, let’s get going!

Create a new page and call it ‘Programme timeline’ then from the macro dropdown select ‘other macros’.


In macro modal screen, search for ‘roadmap planner’ macro then select it.


You will now see the default view of the Roadmap planner macro for you to edit.

Within this view you’ll be able to:

  1. Add a lane to break up the view into discrete swim lanes
  2. Add new bars which you can then drag across and into the swim lanes.
  3. Create markers to display key milestones or dates.
  4. Toggle between weeks or months in which your roadmap will be displayed.
  5. Set the displayed start and end date of the roadmap.


When you’re in the edit view of the roadmap macro it is super simple to move the bars around. With a click and drag gesture of your mouse or trackpad you can drag the bars up and down the timeline, drag the bars into other swim lanes, and modify the bars duration by dragging out their start and end dates.


In our example we are going to create 3 swim lanes:

  1. “Approved” for all projects that have been approved by the client.
  2. “Pipeline” projects that are likely to happen but yet to be formalised approved by the client.
  3. “Dependencies” to display key periods that the team need to be aware of, such as client holidays or events such as Christmas.

First up, let’s give the bars a name.

Go back into edit mode of the page and double click on the macro to edit it. Click on a bar and you’ll see the pop-over allowing you to name the bar.


Similarly, you can give the give the bar a description. This is a really useful feature, especially when your team just want a quick overview of what the bar represents, but don’t want to jump into the project documentation.


Now link up the bars to project documentation or other Confluence pages by linking to existing pages, or create new pages directly from this pop-up.


I am going to add a name, description and link to the project page for each of the projects in our programme. I will then add those project bars to the appropriate swim lane. But before I do, let’s see how we change the colour of a swim lane and its associated bars. Go into edit mode of the macro, click on the header for the given swim lane. You will then see a popover that will allow you to change the colour of the swim lane and it’s associated bars as seen below.


Let’s save the page to see what it’s looking like.


Looking great! Now let’s add in some markers for key milestones and dates. Go back into edit mode for the macro, click on ‘add marker’, add as many as you need. Drag the markers to the appropriate place in the timeline, give them a name and save the page.


And now we have it, an awesome looking programme roadmap that gives visibility to both yourself and your team! Furthermore, your team can quickly dive into the project documentation from the pop over as seen below. No more emails from your team asking you to shoot them the link to the project 🙂


Boss tip!
Add the programme timeline page above or below your programme summary page to give you and the team the complete programme overview.
I’ll detail how this is achieved in the next post.


I hope you found this post useful, please leave your thoughts and comments in the comments section below.


Posted by Liam Holmes