Jira is getting a fresh new look and navigation

We’re in the process of rolling out these changes and the documentation may not match your experience. Bear with us while we update it to reflect the new changes. More about navigating the new Jira

Manage epics in a scrum project

This page is for company-managed projects

To check whether your project is team-managed or company-managed, select More actions (•••) next to the project name in either the header or the sidebar. At the bottom of the menu that opens, you’ll be able to view whether your project is team-managed or company-managed.

More about the difference between company-managed and team-managed projects.

Before you begin

The functions for managing epics require different permissions. For example, you need the 'Edit work items' permission to add a work item to an epic. Read Permissions overview for more information.

Manage epics

To manage your epics from the backlog:

  1. Go to the Backlog of your Scrum project.

  2. Open the epic panel by using the toggle in the epic filter dropdown.

Task

Instructions

Add a new epic

In the epic panel, select + Create epic.

You can also select Create in the top navigation bar, then change the work type to Epic.

Update an epic's details

To expand an epic’s details, select the chevron (>) next to an epic’s name.

Select View details to open the work item, where you can update the epic’s details.

Change an epic's color on the board

To expand an epic’s details, select the chevron (>) next to an epic’s name.

Select View details to open the work item, then select the colored square next to the epic’s name to view all color options. Select a color to apply it to the epic.

Add a work item to an epic

To add an existing work item, drag and drop the work item onto the epic in the panel.

To add a new work item, expand an epic’s details by selecting the chevron (>) next to an epic’s name, then select Create work item.

While creating a work item, you can also add it to an epic by selecting it in the Epic Link field.

Remove a work item from an epic

Drag and drop the work item onto the No epic section in the panel.

Alternatively, open the work item, locate the Epic Link field, then select the 'x' in the epic name lozenge.

Filter work items by epic

Select the relevant epic in the panel to show only work items in that epic. To remove the filter, ensure that no epic is selected in the panel.

Complete an epic

Expand an epic’s details by selecting the chevron (>) next to an epic’s name, then select View details. In the work item, you can change the epic’s status to “Done”.

This will set the epic's Epic Status field to "Done", but will not affect the epic's workflow or its Status field, and none of the epic's work items will be affected.

Need help? If you can't find the answer you need in our documentation, we have other resources available to help you. See Getting help.

Still need help?

The Atlassian Community is here for you.