debian-mirror-gitlab/doc/user/group/epics/linked_epics.md
2022-05-07 20:08:51 +05:30

79 lines
2.8 KiB
Markdown

---
stage: Plan
group: Product Planning
info: 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
---
# Linked epics **(ULTIMATE)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/353473) in GitLab 14.9 [with a flag](../../../administration/feature_flags.md) named `related_epics_widget`. Enabled by default.
FLAG:
On self-managed GitLab, by default this feature is available. To hide the feature,
ask an administrator to [disable the feature flag](../../../administration/feature_flags.md)
named `related_epics_widget`. On GitLab.com, this feature is available.
Linked epics are a bi-directional relationship between any two epics and appear in a block below
the epic description. You can link epics in different groups.
The relationship only shows up in the UI if the user can see both epics. When you try to close an
epic that has open blockers, a warning is displayed.
NOTE:
To manage linked epics through our API, visit the [epic links API documentation](../../../api/linked_epics.md).
## Add a linked epic
Prerequisites:
- You must have at least the Reporter role for both groups.
- For GitLab SaaS: the epic that you're editing must be in a group on GitLab Ultimate.
The epics you're linking can be in a group on a lower tier.
To link one epic to another:
1. In the **Linked epics** section of an epic,
select the add linked epic button (**{plus}**).
1. Select the relationship between the two epics. Either:
- **relates to**
- **[blocks](#blocking-epics)**
- **[is blocked by](#blocking-epics)**
1. Enter the epic number or paste in the full URL of the epic.
![Adding a related epic](img/related_epics_add_v14_9.png)
Epics of the same group can be specified just by the reference number.
Epics from a different group require additional information like the
group name. For example:
- The same group: `&44`
- Different group: `group&44`
Valid references are added to a temporary list that you can review.
1. Select **Add**.
The linked epics are then displayed on the epic grouped by relationship.
![Related epic block](img/related_epic_block_v14_9.png)
## Remove a linked epic
Prerequisites:
- You must have at least the Reporter role for the epic's group.
To remove a linked epic, in the **Linked epics** section of an epic,
select **Remove** (**{close}**) next to
each epic.
The relationship is removed from both epics.
![Removing a related epic](img/related_epics_remove_v14_9.png)
## Blocking epics
When you [add a linked epic](#add-a-linked-epic), you can show that it **blocks** or
**is blocked by** another epic.
If you try to close a blocked epic using the "Close epic" button, a confirmation message appears.