• 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 item to be inserted and select it

  3. Select Insert

You can also type / on the page to bring up the same list you'd see by selecting from the toolbar.

To edit the Roadmap Planner macro:

  1. Select the macro placeholder. The floating toolbar appears.

  2. Select Edit. The right panel opens.

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

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


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