---
metadata:
- name: generator
content: Diplodoc Platform v5.47.3
alternate:
- https://yandex.com.tr/support/tracker/en/manager/epic.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/tracker/en/llms.txt
# How to use epics and user stories
In [Agile development](https://yandex.cloud/en/blog/posts/2022/10/agile-and-project-management), tasks are broken down into epics and user stories.
For example, if a team is developing an electronic document management app, an epic might be adding a module for editing spreadsheets. This epic can include user stories such as the ability to add rows and columns, change cell borders, set colors, and other features. Each user story can then be divided into specific tasks assigned to designers, developers, and testers.
To create epics and user stories in Yandex Tracker, use the **Epic** and **Story** issue types. To use these issue types, add them to the queue workflow: [How to set up a workflow](https://yandex.com.tr/support/tracker/en/manager/workflow.md).
Here's what you need to know about **Epic** issues:
* An epic cannot have a parent issue.
* Issues can be added to an epic using the **Epic for — Sub-epic** link type.
* An epic cannot be another epic's sub-epic.
To learn more about links, see [How to change issue links](https://yandex.com.tr/support/tracker/en/user/ticket-links.md).
## Creating an epic on an issue board {#create-epic}
1. Click **Create issue** on the board.
1. Go to the page with the full issue creation form. To do this, click (**Open full form**).
1. Fill in all the required issue fields. In the **Type** field, specify `Epic`.
1. Click **Create issue**.
## Adding an issue to an epic {#add-to-epic}
You can add an issue to an epic via a [link](https://yandex.com.tr/support/tracker/en/user/ticket-links.md) either from the epic page or issue page.
{% note warning "" %}
An issue can belong to only one epic.
{% endnote %}
### On the epic page {#add-from-epic}
1. On the epic page, click **Add link** under **Related issues**.
1. Select the **Sub-epic** link type.
1. Specify the [issue key](https://yandex.com.tr/support/tracker/en/user/create-ticket.md).
### On the issue page {#add-from-task}
1. On the issue page, click **Add link** under **Related issues**.
1. Select the **Epic** link type.
1. Specify the [epic key](https://yandex.com.tr/support/tracker/en/user/create-ticket.md).
## Creating a new issue in an epic {#create-in-epic}
1. On the epic page under **Epic issues**, click **Add**.
1. Fill in the required fields and save the issue.
## Removing an issue from an epic {#remove-from-epic}
You can remove an issue from an epic either on the issue page or on a board.
### On the issue page {#remove-from-task}
On the issue page, under **Related issues**, remove the link to the epic in the **Epic** section.
### On the issue board {#remove-on-board}
Open the board, [group issues by epic](#group-by-epic), and drag the issue card to **No epic**.
## Grouping issues by epic {#group-by-epic}
You can group issues by epic on your board, in issue filters, or on the queue page:
1. Click in the upper-right corner of the list or the issue board.
1. In the list of options, select **Epic**.
## Filtering issues by epic {#filter-by-epic}
You can also filter issues in a queue or on the issue page using the [query language](https://yandex.com.tr/support/tracker/en/user/query-filter.md):
1. Click **Query language** in the upper-right corner. All the current search parameters that were set using quick filters and conditions will be shown in the query string.
1. Add the filtering conditions by epic to the string, For example:
* Show all issues that have an epic:
```
epic: notEmpty()
```
* Show all issues from the epic with the `EPIC-1` key:
```
epic: "EPIC-1"
```