Skip to content

Planning hierarchies

DETAILS: Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

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:

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.

Hierarchies with epics

With epics, you can achieve the following hierarchy:

%%{init: { "fontFamily": "GitLab Sans" }}%%
graph TD
accTitle: Hierarchies with epics
accDescr: Use epics to link projects, issues, and groups
    Group_epic --> Project1_Issue1
    Group_epic --> Project1_Issue2
    Group_epic --> Project2_Issue1

Hierarchies with multi-level epics

DETAILS: Tier: Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

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

Diagram showing possible relationships of multi-level epics

View ancestry of an issue

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

epics state dropdown list

View ancestry of an epic

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

epics state dropdown list