Planning hierarchies (FREE)

Planning hierarchies are an integral part of breaking down your work in GitLab. To understand how you can use epics and issues together in hierarchies, remember the following:

Epics exist in groups.
Issues exist in projects.

GitLab is not opinionated on how you structure your work and the hierarchy you can build with multi-level epics. For example, you can use the hierarchy as a folder of issues for bigger initiatives.

To learn about hierarchies in general, common frameworks, and using GitLab for portfolio management, see How to use GitLab for Agile portfolio planning and project management.

View planning hierarchies

Introduced in GitLab 14.8.

To view the planning hierarchy in a project:

On the top bar, select Menu > Projects and find your project.
On the left sidebar, select Project information > Planning hierarchy.

Under Current structure, you can see a hierarchy diagram that matches your current planning hierarchy. The work items outside your subscription plan show up below Unavailable structure.

Hierarchies with epics (PREMIUM)

With epics, you can achieve the following hierarchy:

graph TD
    Group_epic --> Project1_Issue1
    Group_epic --> Project1_Issue2
    Group_epic --> Project2_Issue1

Hierarchies with multi-level epics (ULTIMATE)

With the addition of multi-level epics and up to seven levels of nested epics, you can achieve the following hierarchy:

View ancestry of an issue

In an issue, you can view the parented epic above the issue in the right sidebar under Epic.

View ancestry of an epic (PREMIUM)

In an epic, you can view the ancestors as parents in the right sidebar under Ancestors.