Add issues to epics on the roadmap

This page is for company-managed projects

If the lower-left of your project sidebar says you're in a team-managed project, check out these team-managed project articles instead.

Learn more about the difference between company-managed and team-managed projects.

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

Manage child issues from the roadmap

This feature is gradually rolling out, and may not be on your instance quite yet.

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 Jul 20, 2021
Cached at 1:17 PM on Aug 1, 2021 |

Additional Help

Ask the Community