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.

Adding a linkAdding a link

Create links with other issues:

1. Insert the issue key into the issue's description or comment body. You will see the linked issue in the Links tab.

2. If necessary, change the link type to any of the ones available.

Creating a sub-issueCreating a sub-issue

You can break down your complex issues into simpler sub-issues and track their resolution separately. After creating a sub-issue, you can change the link type.

To create a sub-issue:

1. Open the issue to create a sub-issue for.

2. In the top-right corner of the page, click and select Create sub-issue.

3. Fill in the fields the same way as when creating a new issue.

4. Click Create issue. You will see a link to the parent issue next to the sub-issue name.

Changing the link typeChanging the link type

To change an issue's link type:

1. Open one of the two linked issues.

2. Click the Links tab.

3. Next to the linked issue, tap → Change link type and choose a new type.

Removing a linkRemoving a link

To remove an issue's link:

1. Open one of the two linked issues.

2. Click the Links tab.

3. Next to the linked issue, click and select Remove link.