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 the macro appears on a page:

Use the Roadmap macro

To add the Roadmap macro:

  1. In the Confluence editor, choose > Other Macros
  2. Find and select the required macro

Speeding up macro entry with autocomplete:

  • In the new editor - Type / and the beginning of an element (tool or things in the insert menu) to see a list of suggestions.
  • In the legacy editor - Type { and the beginning of the macro name to see a list of suggested macros.

Details are in Keyboard shortcuts, markdown, and autocomplete.

To edit an existing macro

Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the macro.

Edit 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 macro looks 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.