2020-06-23 00:09:42 +05:30
---
stage: Plan
group: Project Management
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/#designated-technical-writers
---
2019-09-30 21:07:59 +05:30
# Related issues **(STARTER)**
2019-07-31 22:56:46 +05:30
2020-03-13 15:44:24 +05:30
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/1797) in [GitLab Starter](https://about.gitlab.com/pricing/) 9.4.
2019-07-31 22:56:46 +05:30
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.
The relationship only shows up in the UI if the user can see both issues.
## Adding a related issue
2020-05-24 23:13:21 +05:30
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/2035) in [GitLab Starter](https://about.gitlab.com/pricing/) 12.8.
> - [Improved](https://gitlab.com/gitlab-org/gitlab/-/issues/34239) in [GitLab Starter](https://about.gitlab.com/pricing/) 13.0.
> When you try to close an issue with open blockers, you'll see a warning that you can dismiss.
2019-07-31 22:56:46 +05:30
You can relate one issue to another by clicking the related issues "+" button
in the header of the related issue block. Then, input the issue reference number
or paste in the full URL of the issue.
2020-03-13 15:44:24 +05:30
Additionally, you can select whether the current issue relates to, blocks, or is blocked by the issues being entered.
2019-07-31 22:56:46 +05:30
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:
- same project: `#44`
2019-10-12 21:52:04 +05:30
- same group: `project#44`
2019-07-31 22:56:46 +05:30
- different group: `group/project#44`
Valid references will be added to a temporary list that you can review.
2020-03-13 15:44:24 +05:30
When you have added all the related issues, click **Add** to submit.
Once you have finished adding all related issues, you will be able to see
them categorized so their relationships can be better understood visually.
2019-07-31 22:56:46 +05:30
2020-03-13 15:44:24 +05:30
2019-07-31 22:56:46 +05:30
## Removing a related issue
In the related issues block, click the "x" icon on the right-side of each issue
token that you wish to remove. Due to the bi-directional relationship, it
will no longer appear in either issue.
2020-03-13 15:44:24 +05:30
2019-07-31 22:56:46 +05:30
2019-09-04 21:01:54 +05:30
Please access our [permissions ](../../permissions.md ) page for more information.
2019-07-31 22:56:46 +05:30
2019-09-04 21:01:54 +05:30
Additionally, you are also able to manage related issues through [our API ](../../../api/issue_links.md ).
