Create a Project Roadmap in Confluence

Use a roadmap diagram to show milestones, work streams, and important dependencies alongside project documentation. This tutorial assumes that the DrawMotive macro is installed on your Confluence Cloud site.

Insert the macro

1. Open your Confluence page in edit mode.
2. Insert the DrawMotive macro using the macro browser.
3. Focus the canvas in the macro editor.

The host shows the available keyboard tools above the canvas. See the Confluence guide for the full key list.

Build a timeline

Use T for Text to place a row of period labels, such as Q1, Q2, Q3, and Q4. Leave space below the labels for each work stream.

Use R for Rectangle to draw bars representing initiatives. Label them with Text, for example Core Editor, Documentation, and Release Preparation. Adjust their positions and sizes to show the intended sequence and duration.

Add milestones and dependencies

Use D for Diamond to mark milestones such as Beta Launch and Public Release. Use A for Arrow to connect work that depends on an earlier milestone. Add short text notes to explain a dependency where its meaning would otherwise be unclear.

Press Escape to cancel an interaction, then V to return to Select. Move and resize objects to improve spacing. Keep the number of dependencies small enough for readers to follow.

Publish

1. Choose Publish in the DrawMotive macro editor.
2. Confirm that the saved preview appears on the page.
3. Publish the Confluence page.

To revise the roadmap, edit the existing macro and publish the updated diagram. Discard & close leaves unpublished changes out of the saved diagram.

Keep the roadmap useful

• Use short milestone labels and explain details in the surrounding page.
• Keep related work in the same row.
• Review spacing after moving a milestone.
• Coordinate with other page editors before changing the same macro.

The macro does not provide simultaneous multi-user editing. Storage limits apply to both the editable document and preview; if publication reports that the document is too large, reduce its content and retry.