Enable agile features

On this page

In this section

Still need help?

The Atlassian Community is here for you.

Ask the community

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 projects, and aren't available in classic projects.

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 Roadmaps feature.

Create epics

To create an epic, click the + in the first column of the roadmap. Note that epics will only display on the Roadmap, and won't display on your project's Board or Backlog. 

Understand your roadmap

  1. 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.
  2. Timestamp update: This shows when the Roadmap was last updated. This will also reflect if an epic that appears on the Roadmap was updated somewhere else, like on the Board or Backlog.
  3. Timeline views: Change the zoom level of your roadmap (Quarters, Months, Weeks) by clicking the Timeline dropdown.
  4. Epic color: Change the color of an epic.
  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).
  6. Epics without set dates: If an epic doesn't have a set start or end date, the ends of the horizontal bar will appear rounded. If no start date is set, the epic will automatically begin on the day the first issue was added. If no end date is set, the epic will automatically end one month from the day it was created.

Add new issues to epics

  1. Epic color: Change the color of an epic. 
  2. Add a child issue: Use the quick-add button to add the first child issue to your epic.
  3. Add more issues: Once you have one child issue, you can use the + above the list to add more.
  4. Child issues list: View and open all of the child issues for this epic.

Export your roadmap

You can share your roadmap with offline users by exporting it as an image (.png format) to use in a presentation deck, attach it to a project documentation, or even print it into a poster to put up on your team’s wall. 

To export a roadmap to an image file:

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

The image will be automatically downloaded by your browser.

Add or change an issue's epic

You can add existing issues to epics, change the epic an issue belongs to, or remove issues from epics from the issue view, board or backlog. Check out Manage epics in next-gen projects to see how.

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

Last modified on Apr 12, 2019

Was this helpful?

Provide feedback about this article

In this section

Powered by Confluence and Scroll Viewport.