1--- 2stage: Plan 3group: Product Planning 4info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments 5--- 6 7# Epic boards **(PREMIUM)** 8 9> - [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/5067) in GitLab 13.10. 10> - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/290039) in GitLab 14.1. 11 12INFO: 13Try epic boards and more with a 14[free 30-day trial of GitLab Ultimate](https://about.gitlab.com/free-trial/index.html?glm_source=docs.gitlab.com&glm_content=p-epics-boards-docs). 15 16Epic boards build on the existing [epic tracking functionality](index.md) and 17[labels](../../project/labels.md). Your epics appear as cards in vertical lists, organized by their assigned 18labels. 19 20To view an epic board: 21 221. On the top bar, select **Menu > Groups** and find your group. 231. On the left sidebar, select **Epics > Boards**. 24 25![GitLab epic board - Premium](img/epic_board_v14_1.png) 26 27## Create an epic board 28 29Prerequisites: 30 31- You must have at least the [Reporter role](../../permissions.md#group-members-permissions) for a group. 32 33To create a new epic board: 34 351. On the top bar, select **Menu > Groups** and find your group. 361. On the left sidebar, select **Epics > Boards**. 371. In the upper left corner, select the dropdown with the current board name. 381. Select **Create new board**. 391. Enter the new board's title. 401. Optional. To hide the Open or Closed lists, clear the **Show the Open list** and 41 **Show the Closed list** checkboxes. 421. Optional. Set board scope: 43 1. Next to **Scope**, select **Expand**. 44 1. Next to **Labels**, select **Edit** and select the labels to use as board scope. 451. Select **Create board**. 46 47Now you can [add some lists](#create-a-new-list). 48To change these options later, [edit the board](#edit-the-scope-of-an-epic-board). 49 50## Delete an epic board 51 52> [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/5079) in GitLab 14.0. 53 54Prerequisites: 55 56- You must have at least the [Reporter role](../../permissions.md#group-members-permissions) for a group. 57- A minimum of two boards present in a group. 58 59To delete the active epic board: 60 611. Select the dropdown with the current board name in the upper left corner of the epic boards page. 621. Select **Delete board**. 631. Select **Delete**. 64 65## Actions you can take on an epic board 66 67- [Create a new list](#create-a-new-list). 68- [Remove an existing list](#remove-a-list). 69- [Filter epics](#filter-epics). 70- Create workflows, like when using [issue boards](../../project/issue_board.md#create-workflows). 71- [Move epics and lists](#move-epics-and-lists). 72- Change epic labels (by dragging an epic between lists). 73- Close an epic (by dragging it to the **Closed** list). 74- [Edit the scope of a board](#edit-the-scope-of-an-epic-board). 75 76### Create a new list 77 78Prerequisites: 79 80- You must have at least the [Reporter role](../../permissions.md#group-members-permissions) for a group. 81 82To create a new list: 83 841. On the top bar, select **Menu > Groups** and find your group. 851. On the left sidebar, select **Epics > Boards**. 861. In the upper-right corner, select **Create list**. 871. In the **New list** column expand the **Select a label** dropdown and select the label to use as 88 list scope. 891. Select **Add to board**. 90 91### Remove a list 92 93Removing a list doesn't have any effect on epics and labels, as it's just the 94list view that's removed. You can always create it again later if you need. 95 96Prerequisites: 97 98- You must have at least the [Reporter role](../../permissions.md#group-members-permissions) for a group. 99 100To remove a list from an epic board: 101 1021. On the top of the list you want to remove, select the **List settings** icon (**{settings}**). 103 The list settings sidebar opens on the right. 1041. Select **Remove list**. A confirmation dialog appears. 1051. Select **OK**. 106 107## Create an epic from an epic board 108 109> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/233568) in GitLab 14.0. 110 111Prerequisites: 112 113- You must have at least the [Reporter role](../../permissions.md#group-members-permissions) for a group. 114- You must have [created a list](#create-a-new-list) first. 115 116To create an epic from a list in epic board: 117 1181. On the top of a list, select the **New epic** (**{plus}**) icon. 1191. Enter the new epic's title. 1201. Select **Create epic**. 121 122![Create a GitLab epic from an epic board](img/epic_board_epic_create_v14_1.png) 123 124### Filter epics 125 126> [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/5079) in GitLab 14.0. 127 128Use the filters on top of your epic board to show only 129the results you want. It's similar to the filtering used in the epic list, 130as the metadata from the epics and labels is re-used in the epic board. 131 132You can filter by the following: 133 134- Author 135- Label 136 137### View count of issues, weight, and progress of an epic 138 139> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/331330) in GitLab 14.1. 140 141Epics on an epic board show a summary of their issues, weight, and progress. 142To see the number of open and closed issues and the completed and incomplete 143weight, hover over the issues icon **{issues}**, weight icon **{weight}**, or 144progress icon **{progress}**. 145 146### Move epics and lists 147 148> [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/5079) in GitLab 14.0. 149 150You can move epics and lists by dragging them. 151 152Prerequisites: 153 154- You must have at least the [Reporter role](../../permissions.md#group-members-permissions) for a group. 155 156To move an epic, select the epic card and drag it to another position in its current list or 157into another list. Learn about possible effects in [Dragging epics between lists](#dragging-epics-between-lists). 158 159To move a list, select its top bar, and drag it horizontally. 160You can't move the **Open** and **Closed** lists, but you can hide them when editing an epic board. 161 162#### Dragging epics between lists 163 164When you drag epics between lists, the result is different depending on the source list 165and the target list. 166 167| | To Open | To Closed | To label B list | 168| --------------------- | -------------- | ---------- | ------------------------------ | 169| **From Open** | - | Close epic | Add label B | 170| **From Closed** | Reopen epic | - | Reopen epic and add label B | 171| **From label A list** | Remove label A | Close epic | Remove label A and add label B | 172 173### Edit the scope of an epic board 174 175Prerequisites: 176 177- You must have at least the [Reporter role](../../permissions.md#group-members-permissions) for a group. 178 179To edit the scope of an epic board: 180 1811. In the upper-right corner, select **Edit board**. 1821. Optional: 183 - Edit the board's title. 184 - Show or hide the Open and Closed columns. 185 - Select other labels as the board's scope. 1861. Select **Save changes**. 187