Roadmap Planner Macro

Create simple, visual timelines that are useful for planning projects, software releases and much more with the Roadmap macro.

Roadmaps are made up of: 

  • bars to indicate phases of work 
  • lanes to differentiate between teams, products or streams
  • markers to highlight important dates and milestones 
  • a timeline showing months or weeks.

You can provide more information about items on your roadmap by linking a bar to a page. 

Here's how it appears on a page:

Adding the Roadmap macro

To add the Roadmap macro to a page:

  1. From the editor toolbar, choose Insert > Other Macros
  2. Find and select the required macro

Speed it up with autocomplete: Type and the beginning of the macro name, to see a list of suggested macros. In this example we're inserting the cheese macro.

To edit an existing macro: Click the macro placeholder and choose Edit. This will open the macro details, so you can edit the macro parameters.

Editing your Roadmap

To edit your roadmap:

  • Select the roadmap and choose Edit.
  • Add lanes, bars and markers.
  • Drag lanes, bars and markers to the desired location on the roadmap.
  • Select lanes, bars and markers to add text, change colors and remove from the roadmap.
  • Select bars to add links to existing pages, create new pages or add a description. 
  • Set the start and end dates for the roadmap and choose to display it by weeks or months.

Here's how the roadmap planner appears in the editor:

  1. Add lanes: to differentiate your teams or streams of work.
  2. Date range: display the plan by weeks or months.
  3. Add bar info: to provide more info or link a bar to a page. 


This macro does not use the macro browser to set parameters. You also cannot add this macro via wiki markup or by editing the storage format directly. 


The Roadmap macro was previously available from The Marketplace. The macro has changed significantly. If you had an older version of the macro installed you will be able to view your existing roadmaps but not edit them. 

tip/resting Created with Sketch.

Do more with Confluence

To extend Confluence's roadmap capability, check out these apps on the Atlassian Marketplace

Last modified on Jul 19, 2021

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.