Completing an Epic
An epic captures a large body of work. It is essentially a large user story that can be broken down into a number of smaller stories. It may take several sprints to complete an epic.
In JIRA Agile, an epic is simply an issue of type "Epic", which has a name (e.g. "My New Feature") with which other issues can be associated (linked).
Typically, once all of an epic's issues have been completed, you will want to complete the epic. However, you can complete an epic even if some of its issues are incomplete.
Please note:
This page only applies to Scrum boards.
Completing an epic
Please note:
- You will need to have the "Edit Issue" permission in the project to which the epic belongs.
To complete an epic,
- Click the Agile link's down-arrow in the top navigation bar, then select your preferred board from the resulting dropdown menu.
- Click Backlog.
- If the Epic panel is not shown at the left of the screen, select Tools > Show Epic Panel.
- In the Epic panel, hover over the epic you wish to rename, click the drop-down that appears, and select Mark as Done (see Screenshot 1 below). This will set the epic's Epic Status field (see JIRA Agile - JIRA Configuration) to "Done", but will not affect the epic's workflow or its Status field, and none of the epic's issues will be affected.
Screenshot 1: completing an epic
Re-opening an epic
Out of the box, there is no way to re-open an epic. However, you can re-open an epic by following the steps below.
Please note:
- You will need to have the "Edit Issue" permission in the project to which the epic belongs.
- You will need to have the "JIRA Administrator" global permission.
To re-open an epic,
- Add the Epic Status field (see JIRA Agile - JIRA Configuration) to the View and Edit screens of your project (see custom field context).
- View the epic issue in JIRA
- Edit the epic issue and set Epic Status to either "To Do" or "In Progress".
- (optional) Undo step 1.