Epics

An epic is an issue type that allows you to group issues sharing the same subject. Epics can include issues from different queues and sprints.

Epics are convenient for breaking down your activities if you follow the Agile methodologies. The largest issues can be epics. You break these down into stories, and stories into issues for assignees.

Creating an epic on a boardCreating an epic on a board

1. On the board, click Create issue.
2. Go to the page with the full issue creation form. To do this, click (Open full form).
3. Fill in all the required issue fields. In the Type field, specify Epic.
4. Click Create issue.

Adding an issue to an epicAdding an issue to an epic

You can add an issue to an epic via a link either from the epic page or issue page.

Adding an issue from the epic pageAdding an issue from the epic page

1. On the epic page under Related issues, click Add link.

2. Select the Has epic link type.

3. Specify the issue key.

Adding an issue from the issue pageAdding an issue from the issue page

1. On the issue page under Related issues, click Add link.

2. Select the Epic link type.

3. Specify the epic key.

Creating a new issue in an epicCreating a new issue in an epic

1. On the epic page under Epic issues, click Add.
2. Fill in the required fields and save the issue.

Removing an issue from an epicRemoving an issue from an epic

You can remove an issue from an epic either on the issue page or on a board.

Removing an issue on the issue pageRemoving an issue on the issue page

On the issue page under Related issues, remove the link to the epic in the Epic section.

Removing an issue on a boardRemoving an issue on a board

Open the board, group issues by epic, and drag the issue card to No epic.

Grouping issues by epicGrouping issues by epic

1. In the top-right corner of the board page, click .

2. In the list of options, select Epic.

Filtering issues by epicFiltering issues by epic

You can set up issue display by epic on your board or queue page.

Filtering issues on a boardFiltering issues on a board

To filter issues by epic on your board:

1. In the top-right corner, click  Filters. The filter setup panel will be shown above the board's columns.
2. Click . Select Epic.
3. In the dialog box that opens, enter the key of the epic by which you want to filter issues.

Filtering issues on the queue pageFiltering issues on the queue page

You can also filter issues in a queue or on the issue page using the query language:

1. In the top-right corner of the page, click Query language. All the current search parameters that were set using quick filters and conditions will be shown in the query string.

2. Add the filtering conditions by epic to the string, e.g.:

   • Show all issues that have an epic:

     	epic: notEmpty()
     

   • Show all issues from the epic with the EPIC-1 key:

     	epic: "EPIC-1"