2020-05-26 23:08:26 -04:00
---
stage: Plan
group: Project Management
2020-11-26 01:09:20 -05:00
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
2020-05-26 23:08:26 -04:00
---
2020-09-18 20:09:50 -04:00
# Related issues **(CORE)**
2019-05-05 10:59:11 -04:00
2020-09-18 20:09:50 -04:00
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/1797) in [GitLab Starter](https://about.gitlab.com/pricing/) 9.4.
> - The simple "relates to" relationship [moved](https://gitlab.com/gitlab-org/gitlab/-/issues/212329) to [GitLab Core](https://about.gitlab.com/pricing/) in 13.4.
2019-05-05 10:59:11 -04:00
Related issues are a bi-directional relationship between any two issues
and appear in a block below the issue description. Issues can be across groups
and projects.
2020-09-18 20:09:50 -04:00
You can set any issue as:
- Related to another issue
- Blocking another issue ** (STARTER)**
- Blocked by another issue ** (STARTER)**
2019-05-05 10:59:11 -04:00
The relationship only shows up in the UI if the user can see both issues.
2020-08-09 17:10:01 -04:00
When you try to close an issue that has open blockers, a warning is displayed.
2020-12-07 22:09:37 -05:00
NOTE:
2020-09-18 20:09:50 -04:00
To manage related issues through our API, visit the [issue links API documentation ](../../../api/issue_links.md ).
2020-08-09 17:10:01 -04:00
2019-05-05 10:59:11 -04:00
## Adding a related issue
2020-05-18 14:08:22 -04:00
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/2035) in [GitLab Starter](https://about.gitlab.com/pricing/) 12.8.
2020-08-09 17:10:01 -04:00
> - [Improved](https://gitlab.com/gitlab-org/gitlab/-/issues/34239) to warn when attempting to close an issue that is blocked by others in [GitLab Starter](https://about.gitlab.com/pricing/) 13.0.
2020-09-18 20:09:50 -04:00
> When you try to close an issue with open blockers, you see a warning that you can dismiss.
2020-05-18 14:08:22 -04:00
2020-08-09 17:10:01 -04:00
1. Relate one issue to another by clicking the related issues "+" button
in the header of the related issue block.
1. Input the issue reference number or paste in the full URL of the issue.
2019-05-05 10:59:11 -04:00
2020-09-18 20:09:50 -04:00
1. ** (STARTER)** Select whether the current issue relates to, blocks, or is blocked by the issues being entered.
2020-02-17 22:08:54 -05:00
2020-08-09 17:10:01 -04:00
![Adding a related issue ](img/related_issues_add_v12_8.png )
2020-02-17 22:08:54 -05:00
2020-08-09 17:10:01 -04:00
Issues of the same project can be specified just by the reference number.
Issues from a different project require additional information like the
group and the project name. For example:
2019-05-05 10:59:11 -04:00
2020-08-09 17:10:01 -04:00
- same project: `#44`
- same group: `project#44`
- different group: `group/project#44`
2019-05-05 10:59:11 -04:00
2020-09-18 20:09:50 -04:00
Valid references are added to a temporary list that you can review.
2020-02-17 22:08:54 -05:00
2020-08-09 17:10:01 -04:00
1. When you have added all the related issues, click **Add** to submit.
2020-09-18 20:09:50 -04:00
When you have finished adding all related issues, you can see
2020-02-17 22:08:54 -05:00
them categorized so their relationships can be better understood visually.
2019-05-05 10:59:11 -04:00
2020-02-17 22:08:54 -05:00
![Related issue block ](img/related_issue_block_v12_8.png )
2019-05-05 10:59:11 -04:00
## Removing a related issue
In the related issues block, click the "x" icon on the right-side of each issue
2020-08-09 17:10:01 -04:00
token that you wish to remove.
2020-09-18 20:09:50 -04:00
Due to the bi-directional relationship, it no longer appears in either issue.
2019-05-05 10:59:11 -04:00
2020-02-17 22:08:54 -05:00
![Removing a related issue ](img/related_issues_remove_v12_8.png )
2019-05-05 10:59:11 -04:00
2019-05-31 07:08:09 -04:00
Please access our [permissions ](../../permissions.md ) page for more information.