1--- 2stage: Plan 3group: Project Management 4info: 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 5--- 6 7# Linked issues **(FREE)** 8 9> The simple "relates to" relationship [moved](https://gitlab.com/gitlab-org/gitlab/-/issues/212329) to [GitLab Free](https://about.gitlab.com/pricing/) in 13.4. 10 11Linked issues are a bi-directional relationship between any two issues and appear in a block below 12the issue description. Issues can be across groups and projects. 13 14The relationship only shows up in the UI if the user can see both issues. When you try to close an 15issue that has open blockers, a warning is displayed. 16 17NOTE: 18To manage linked issues through our API, visit the [issue links API documentation](../../../api/issue_links.md). 19 20## Add a linked issue 21 22> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/2035) in GitLab 12.8. 23> - [Improved](https://gitlab.com/gitlab-org/gitlab/-/issues/34239) to warn when attempting to close an issue that is blocked by others in GitLab 13.0. 24> When you try to close an issue with open blockers, you see a warning that you can dismiss. 25 261. Link one issue to another by selecting the add linked issue button (**{plus}**) in the 27 **Linked issues** section of an issue. 28 291. Select the relationship between the two issues. Either: 30 - **relates to** 31 - **blocks** **(PREMIUM)** 32 - **is blocked by** **(PREMIUM)** 331. Input the issue number or paste in the full URL of the issue. 34 35 ![Adding a related issue](img/related_issues_add_v12_8.png) 36 37 Issues of the same project can be specified just by the reference number. 38 Issues from a different project require additional information like the 39 group and the project name. For example: 40 41 - The same project: `#44` 42 - The same group: `project#44` 43 - Different group: `group/project#44` 44 45 Valid references are added to a temporary list that you can review. 46 471. When you have added all the linked issues, select **Add**. 48 49When you have finished adding all linked issues, you can see 50them categorized so their relationships can be better understood visually. 51 52![Related issue block](img/related_issue_block_v12_8.png) 53 54You can also add a linked issue from a commit message or the description in another issue or MR. 55[Learn more about crosslinking issues](crosslinking_issues.md). 56 57## Remove a linked issue 58 59In the **Linked issues** section of an issue, click the remove button (**{close}**) on the 60right-side of each issue token to remove. 61 62Due to the bi-directional relationship, the relationship no longer appears in either issue. 63 64![Removing a related issue](img/related_issues_remove_v12_8.png) 65 66Access our [permissions](../../permissions.md) page for more information. 67