Enable the roadmap

Are you on the right help page?

The following information only applies to next-gen projects.

To check which type project you need help with, look at the bottom of your project’s left-hand sidebar:

  • If you see an icon stating You’re in a next-gen project with Give feedback and Learn more menu items, you're in a next-gen project.

  • If you don't, you're in a classic project. Check out our classic project documentation.

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.

Learn more about the benefits of roadmaps.

Enable/disable the roadmap

The roadmap feature is only available in next-gen software projects.

  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:

Annotated next-gen Roadmap. Consists of: 1 team avatars, 2 epic bar, 3 dependency dropdown, 4 time dropdown, 5 child issues.
  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

The export roadmap dialogue, with a timeline dropdown menu, and start/end date selector.

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.

Cropped image of a the Jira Roadmap macro in Confluence.

Option 3: Macro menu

  1. Select the macro menu ().

  2. Select Jira Roadmap

A plus symbol (+) represents the macro dropdown menu. The Jira Roadmap macro is listed, among several other macros.

Troubleshoot your roadmap

Sometimes a project, or the epics and issues it contains, can prevent you from accessing the roadmap.

Project exceeds issue or epic limit

The roadmap displays all issues and epics in your project. If your project contains more than 3000 issues or 300 epics, the roadmap won’t display.

One way around this is to mark an epic as Done when all of its issues are resolved. An epic resolved over a year ago won’t display on the roadmap. If a resolved epic has a due date of more than a year ago, it also won't display on the roadmap.

It's good practice to set due dates on your epics, so you’re reminded to mark them as done or adjust the due date. You can find the Due date field within the issue view of the epic.

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.

Manage corrupt issues

An issue's considered corrupt if certain details, like the issue type, status, status category, or rank settings are invalid. The details might have been missing when the issue was created or something might have gone wrong with a bulk import.

The roadmap won’t display until the details in the corrupt issue are fixed.

To fix a corrupt issue, you must raise a support ticket. Our team will help fix the issue so you can continue using your roadmap.

Learn more

Additional Help

Ask the Community