“Related Issues” connect different issues together. You can see and check them on the issue page. This feature is available on paid plans.
What you can do with “Related Issues”
“Related Issues” are useful in these cases:
- Creating a new issue in another project based on a request.
- Linking an old issue as a reference.
- Connecting issues without worrying about parent-child hierarchy.
When you type an issue key in a comment and post it, it automatically becomes a “Related Issue”.
Difference between "Related Issues" and "parent and child issues"
Parent and child issues are useful when:
- Assigning issues with the same goal to many people (for example: monthly reports).
- Breaking down one big issue into smaller tasks.
“Related Issues” do not have a hierarchy. You can connect any issues freely. They are helpful when you want to link issues, but the order of work is not decided yet. You can organize them later.
How to add a “Related Issue”
Here are the steps to add a “Related Issue”:
- Click the three dots icon at the top right of the issue page.
- Click "Add related issue".
- Type the issue key in the dialog and select the issue you want to link.
You can also set it up by typing and posting an issue key in the comment box.
“Related Issues” are linked both ways
When you add a “Related Issue” to Issue A, the link is automatically added to Issue B as well.
- Example: If you add HELP-23 as a related issue in TASK-117, TASK-117 is also added as a “Related Issue” in HELP-23.
Important notes when adding Related Issues
- You can add up to 50 “Related Issues” to one issue.
- “Related Issues” are not included in keyword search results.
Who can see Related Issues
Project members can see the content of Related Issues.
Example: When an issue in Project B is linked to an issue in Project A
If a user is a member of both Project A and Project B:
The user can see the Related Issues in both projects.
On the Dashboard and Project Home:
A message shows that a Related Issue was added, along with the issue key.
On the Issue screen:
The following details are shown:
- Issue Key
- Subject
- Assignee (Shows "-" if not set)
- Status
- Start Date (Shows "-" if not set)
- Due Date (Shows "-" if not set)
If a user is a member of Project A, but NOT Project B:
Even if an issue in Project B is linked to Project A, the member cannot see that a Related Issue was added.
How to remove Related Issues
Users with the following privileges can remove Related Issues:
- Admin
- Member (Add issue only / No Restrictions)
- Guest (Add issue only / No Restrictions)
Steps to remove a Related Issue:
- Open the issue that has a Related Issue.
- Move your mouse over the Related Issue.
- Click the "x" icon (Remove related issue) on the right side.
When you remove a Related Issue, a message will appear on the Dashboard and Project Home.
- If you belong to the project that the removed issue is in
- A message shows that the Related Issue was removed.
- If you do not belong to the project that the removed issue is in
- No message appears.