• Products
  • Documentation
  • Resources

Add issues to epics on the roadmap

The Roadmap view in Jira Software is the same for both company-managed projects and team-managed projects, aside from how to enable it and troubleshooting information.

Learn how to enable the roadmap view in your team-managed project

Read more about troubleshooting issues in a team-managed roadmap

There are a few ways to add different issues to your epics.

On the roadmap

To add an issue, hover over an epic and click Add a child issue.

A screenshot of the roadmap epic panel in a company-managed project. The cursor hovers on an epic revealing a create button

Choose which issue type you’d like to create, then tap enter.

A screenshot of the epics in a company-managed roadmap. When creating a child issue, the issue type changes from bug > story

On the issue detail view

Select the epic to see its details, then select either of the following:

  1. Add a child issue button

  2. button in the right side

A cropped screenshot of an epic detail view, annotated to call out the 3 different places you can create child issues

Roll up an epic’s start and end dates

When creating an epic, you can infer start and/or end dates based on the values of its child issues when there are no dates assigned to it. This is what’s referred to as a roll-up, and the dates automatically update as those of the child issues change. If you manually set a date, it will override any rolled-up dates.

If your roadmap is using these dynamic dates, you’ll see an arrow icon next to your schedule bars:

Rollup dates on your roadmap view in Jira Software Cloud

Rollups only work for scrum teams. If you try this with Kanban teams, the epic’s schedule bar will disappear.

To roll-up dates to your epic, right-click on an epic’s schedule bar and select Clear both dates.

Manage child issues from the roadmap

If a child issue is assigned to a sprint, your roadmap will show schedule bar on your timeline. For child issues, the schedule bar is based on the dates of its assigned sprint listed at the top of your timeline, not the start and end dates of the issue.

In order to show a child issue’s schedule bar on your timeline, it must be assigned to a sprint.

Change a sprint assignment

There are three ways that you can change an issue’s sprint assignment from the roadmap.

  1. Select the schedule bar on the timeline, which will open the issue detail view. Find the Sprint field, and add a sprint.

  2. Drag-and-drop your child issue’s schedule bar to a new sprint. As you drag the bar, drop zones will appear in your timeline. Place the bar in one of these shadows to assign it to the sprint. If you have overlapping sprints, the issue will be assigned to the one that begins first.

  3. Right-click on the child issue’s schedule bar and choose which where you’d like to move the issue. You can also clear the sprint assignment from this menu.

Change color of issue schedule bars

All child issues belonging to an epic will have the same color schedule bars on the timeline.

Reorder or reassign an issue to an epic

To reorder issues, select the name or icon from the left column, then drag it to where you want it to live. You can also change the epic to which a child issue is assigned by dragging and dropping it inside of a different epic.

A screenshot of a story-level issue being dragged from one epic to another.

You can also add or remove issues from epics from the issue view, board, or backlog. See Manage epics in a kanban project or Manage epics in a scrum project to learn how.

Last modified on Oct 8, 2021
Cached at 5:38 AM on Oct 25, 2021 |

Additional Help