Related issues
Introduced in GitLab Starter 9.4.
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
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.
Introduced in GitLab 12.8.
Additionally, you can select whether the current issue relates to, blocks, or is blocked by the issues being entered.
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
- same group:
project#44
- different group:
group/project#44
Valid references will be added to a temporary list that you can review. 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.
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.
Please access our permissions page for more information.
Additionally, you are also able to manage related issues through our API.
Help and feedback
If there's something you don't like about this feature
To propose functionality that GitLab does not yet offer
To further help GitLab in shaping new features
If you didn't find what you were looking for
If you want help with something very specific to your use case, and can use some community support
POST ON GITLAB FORUM
If you have problems setting up or using this feature (depending on your GitLab subscription)
REQUEST SUPPORT
To view all GitLab tiers and features or to upgrade
If you want to try all features available in GitLab.com
If you want to try all features available in GitLab self-managed
If you spot an error or a need for improvement and would like to fix it yourself in a merge request
EDIT THIS PAGE
If you would like to suggest an improvement to this doc