Skip to main content
Skip table of contents

Getting started with the New Roadmaps experience

In Jira’s global navigation, open the Apps section to find the Roadmaps app link.

This will take you to the Roadmap list page where you can open or create a Roadmap.

Cloud new nav Roadmaps.png

To create a new Roadmap, you’ll need to:

  1. Give your Roadmap a name

  2. Add at least one Jira board containing the items you’d like to see/schedule on the Roadmap

Create roadmap step 2.png
  1. Set whether your Roadmap should automatically sync with Jira

If you don’t enable automatic synchronization, you can manually publish your changes instead.

Learn more about synchronizing the roadmap wand dates with Jira.

Create Roadmap 3 sync.png

All these settings can be edited later.

Add items to your Roadmap

If there are already items on your Jira board that have dates set, you’ll automatically see those items on the roadmap.

Other items from your source Jira board(s) can be added with the “Add work items” button.

Add issue to roadmap.gif

Items on the Roadmap can be rescheduled with drag-and-drop:

Reschedule issue.gif

If you’ve configured date syncing, changes you make on the Roadmap will automatically be synchronised with Jira.

Customize your timeline view with hierarchy and important milestones

Customize the timeline view

The Date range selector lets you directly control which portion of the timeline is visible. If you have scheduled items but they aren’t displaying, try adjusting the date range.

The Zoom level can be set to Week, Month, Quarter, or Year.

Date range selector.png

Open the Filters menu to select hierarchy levels or work item types from Jira to display, or filter by status.

Filters button and drawer hierarchy levels.png

If you use a hierarchy in Jira, items will automatically display in the hierarchical tree with their parent/child items.

Expand or collapse any part of the tree with the arrow on the left side of the item.

Learn more about hierarchy view.

Hierarchy levels above Epics can only be configured in Jira on Cloud Premium/Enterprise.

Roadmaps GA hierarchy.png

Items under Epics will be collapsed by default.

  • Click the arrow on the left side of the epic to see its child items.

  • In the “View” 👁️ menu, use “Expand all level 1 issues” to load all story-level items at once.

View dropdown Expand level 1 off highlighted.png

Date markers and version

Add Markers to see important dates on the timeline:

  • Custom date markers

  • Version markers based on Jira Releases

Learn more about Markers.

Date marker on hover.png

Share your Roadmap

You can export your Roadmap as a PNG to share your plans with stakeholders outside of Jira.

Find the “Export Roadmap” button in the top right-hand corner.

Export Roadmap button highlighted.png
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.