debian-mirror-gitlab/doc/user/project/issues/related_issues.md
2021-03-11 19:13:27 +05:30

2.9 KiB

stage group info
Plan Project Management 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

Related issues (FREE)

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.

You can set any issue as:

  • Related to another issue
  • Blocking another issue (STARTER)
  • Blocked by another issue (STARTER)

The relationship only shows up in the UI if the user can see both issues.

When you try to close an issue that has open blockers, a warning is displayed.

NOTE: To manage related issues through our API, visit the issue links API documentation.

  1. Relate one issue to another by clicking the related issues "+" button in the header of the related issue block.

  2. Input the issue reference number or paste in the full URL of the issue.

  3. (STARTER) Select whether the current issue relates to, blocks, or is blocked by the issues being entered.

    Adding a related issue

    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 are added to a temporary list that you can review.

  4. When you have added all the related issues, click Add to submit.

When you have finished adding all related issues, you can see them categorized so their relationships can be better understood visually.

Related issue block

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 no longer appears in either issue.

Removing a related issue

Please access our permissions page for more information.