Editing issue links
You can link issues to other issues to group multiple issues based on a common topic or set the issue hierarchy.
The number of links per issue is unlimited. The list of related issues is shown under the issue description.
You can also link issues and repository commits.
Issue links are created automatically when an issue key is entered into the issue's description or comment body.
Adding a link
Create links with other issues:
-
Open the issue to add a link for.
-
Go to the Links section and tap
. -
Select an issue to link:
New issueExisting issue-
To create an issue, click New. Enter a name for the issue and select the queue where you want to create it.
If you can create an issue in the queue only using a form, you'll see the Select form button on the screen.
-
Select an issue type.
-
Click Create.
A new issue page will open.
-
If an issue already exists, click Existing. Start typing its key or name, then select the issue from the list.
-
Click Create.
-
Creating a sub-issue
You can break down your complex issues into simpler sub-issues and track their resolution separately.
To create a sub-issue:
-
Open the issue to create a sub-issue for.
-
In the top-right corner of the page, click
and select Create sub-issues.If you can create an issue in the queue only using a form, you'll see the Select form button on the screen.
-
Enter a name for the issue and select the queue where you want to create it.
-
Select an issue type.
-
Click Create.
A new issue page will open.
Creating a sub-issue from an issue
You can make your issue a part of a larger issue.
-
In the top right corner, click
→ Convert to sub-issue. -
Start typing the key or name of the parent issue, then select one from the list.
Changing the link type
To change an issue's link type:
-
Open one of the two linked issues.
-
Go to Links.
-
To the right of the linked issue, tap
→ Change link type and choose a new type.
Removing a link
To remove an issue's link:
-
Open one of the two linked issues.
-
Go to Links.
-
To the right of the linked issue, tap
and select Remove link.