The roadmap is where you can create, manage and visualize your team's epics. Roadmaps are useful for planning large pieces of work several months in advance, and planning large groups of stories across different sprints.

Roadmaps are only available in next-gen Jira Software Cloud projects.

They aren't available in classic projects or in Jira Server or Data Center products. If you're unsure, check the bottom of your project sidebar. If you see the Give feedback and Learn more menu items, you're in a next-gen project.

Enable/disable the roadmap

  1. Navigate to your next-gen Jira Software project.
  2. From your project's sidebar, select Project settings > Features.
  3. Enable or disable the Roadmap feature.

Understand your roadmap

The roadmap comes with the following features:

  1. Filters - Use the assignee and type filters to specify which issues are displayed on your roadmap. These filters will automatically appear when you add an assignee to an issue or create more than one type of issue.

  2. Date ranges: Hover on an epic to view its date range. Drag its left and right edges to adjust the date range, or click the epic to open it and edit its details.

  3. Views: Hide or show your epics' dependencies and progress on the roadmap.

  4. Timeline: Change the zoom level of your roadmap to view upcoming weeks, months, or quarters by selecting this dropdown.

  5. Add issues to epics: Click an epic to open its details and add child issues. They'll automatically appear on your board and backlog (if you've enabled the backlog feature).

Share your roadmap

Export your roadmap

You can share your roadmap with offline users by exporting it as an image (PNG format) to use in a presentation, attach to project documentation, or even to print as a poster for your team's wall. 

To export a roadmap to an image:

  1. While viewing your roadmap, select Export
  2. Choose the Timeline view, Start date and End dates, then select Export

Your browser automatically downloads the image.

Add your roadmap to a Confluence Cloud page

You can add your team's roadmap to a Confluence Cloud page using the Jira Roadmap macro. Roadmaps you add to a Confluence Cloud page will update in real-time, and you can interact with it just as you would in Jira.

There are 3 ways to add your roadmap to a Confluence Cloud page.

Option 1: Paste a URL

  1. Go to your next-gen Jira Software project and view the Roadmap.

  2. Copy the URL from your browser.

  3. Paste that URL directly into your Confluence page.

It will automatically be transformed into a Jira Roadmap macro.

Option 2: Macro shortcut menu

  1. Bring up the macro shortcuts menu with either '/' (in the new Confluence Cloud editor) or '{' (in the classic editor). 
  2. Search for Jira Roadmap.

Option 3: Macro menu

  1. Select the macro menu (+).
  2. Select Jira Roadmap

Troubleshoot your roadmap

The following problems in your project can prevent you from accessing the Roadmap:

  • No epic issue type: If your project doesn't have an epic issue type, the Roadmap won't display. Note that the issue type must be a high-level issue type, so a regular issue type that happens to be called "Epic" still won't work. To fix this, you can navigate to the Roadmap to either create a new epic issue type, or select an existing issue type and designate it as the epic issue type.
  • No date fields on epic issue type: Epic issue types must have a Start date and Due date field to display on the Roadmap. If these are deleted, you can navigate to the Roadmap to have them re-added.
  • Accidentally converted a story-level issue type to an epic: If you've mistakenly converted an issue type to an epic, and your issues no longer display on the board and backlog, you can restore these issues to their original state with the following steps:
    1. Create a new story-level issue type.
    2. Delete the 'wrong' epic type (that was converted).
    3. As part of the issue type deletion process, you'll be asked which new issue type you'd like to move all your issues to.
    4. Select the new issue type you created.
    5. Rename this new issue type to your old one, if you want to.

Learn more