DocsProjects
Epics
Bigger pieces of work that hold the tasks.
An epic is a bigger piece of work inside an area, like "Checkout redesign". Tasks always go under an epic, so an epic is where most of your work lives. Planning a release? See Plan a release.
Make an epicLink to this section
- Hover an area in the sidebar and click its
+. - Pick New epic from an area's or project's right-click menu.
- Click New epic on an area's page.
The title can carry fields, like !high or @me. See New tasks and quick add.
Epics in the sidebarLink to this section
Epics show under their area, five at a time, with "More epics…" after them. A done epic keeps its place there. When an epic is done, or all its tasks are, a green tick replaces the bar. Each has a small progress bar. You can change how many show, or turn the bars off, in Settings.
Right-click an epic and pick Pin to top to keep it at the top of its area, on top of the five. Drag epics, or use Move up and Move down, to put them in your own order. See Pins and your own order.
The epic pageLink to this section
Click an epic to open its page at /p/<KEY>/e/<ID>. Under the list toolbar is the epic itself: its progress, fields, tags and description. You can edit all of them right there. Click the title to rename the epic, or pick Rename… from its right-click menu in the sidebar. Beside them are Comments (which opens the issue panel), Copy link, Open in YouTrack and Delete.
The list below holds the epic's tasks and their subtasks, at every depth. The epic itself never appears in it. New task adds a task under the epic.
Give an epic a colourLink to this section
Right-click the epic in the sidebar and pick Colour…, or use the Colour button at the top of the epic's page. Pick any colour from your device's picker, type a hex code, or take one of the suggested colours, then click Save; No colour takes it off. The picker works the same as for areas. The colour fills the epic's diamond in the sidebar, in lists and on dashboards.
The colour is yours: it follows you to your other devices, Reset leaves it alone, and teammates pick their own.
Move an epicLink to this section
- To another area: drag the epic onto the area in the sidebar, from the sidebar or from a list. Or right-click it and pick Move to area.
- Into an area folder: right-click it and pick Move to folder. See Folders.
Moving an epic to another area takes it out of its folder. Its tasks and subtasks always carry their epic's area, so the whole tree moves with it.
Move a task to another epicLink to this section
Open the task. Its panel has an Epic field under Area; pick another epic there and the task moves under it, with its subtasks.
Changing the task's Area moves it too. A task can't sit loose in an area, so it goes under that area's open epic with the most recent activity, and the Epic field shows which one. Pick a different epic there if that's the wrong one. Areas with no open epic are greyed out in the list; add an epic there first.
A subtask under another task follows its parent, so it has no Epic field. Changing its Area takes it out from under that task and puts it under an epic in the new area.
Turn an issue into an epicLink to this section
In Unsorted or any list, right-click a top-level issue and pick Make it an epic.
Delete an epicLink to this section
Pick Delete epic from its right-click menu, or Delete on its page. Suru Me asks first. The epic's tasks are kept and move to Unsorted.