• Products
  • Documentation
  • Resources

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

Shows a preview of a roadmap created with the roadmap planner macro

Use the Roadmap Planner macro

To add the Roadmap Planner macro:

  1. When editing, select from the toolbar

  2. Find the macro by name and select it

  3. Configure it as needed

You can also type / on the page to bring up the same list you'd see by selecting from the toolbar. Continue typing the name of the macro to filter the list.

To edit the Roadmap Planner macro:

  1. Select the macro placeholder.

  2. Select the Edit icon to open the configuration panel.

  3. Configure the parameters. Your changes are saved as you go.

  4. Resume editing the page, and the panel closes.

You can also select the centered , medium-width , and full-width icons to adjust the width of some macros. Select the trashcan iconto remove 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

Shows the setup of the roadmap with callouts that correspond to the list of items below it
  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. 

Additional Help