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. Under the issue description, click Add link.

2. Select a relevant link type and create a link:

   • To create an issue, click the New issue tab. Give your issue a name and press Enter.

   • If the issue already exists, click Existing issue, specify the issue key or name, and select the issue from the list. You can find the key on the issue page, under the title (for example, TEST-1234).

To add a link to multiple issues, use bulk operations.

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 page to create a sub-issue for.

2. In the top-right corner, select Actions → Add 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 at the top of the page above the sub-issue name.

Changing the link typeChanging the link type

To change an issue's link type:

1. Open the page of one of the two linked issues.

2. In the Related list under the issue description, select the link whose type you want to change.

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 the page of one of the two linked issues.

2. In the Related list under the issue description, select the link you want to remove.

3. Next to the linked issue, click → Remove link.

Creating a sub-issue from an issueCreating a sub-issue from an issue

You can make your issue a part of a larger (parent) issue:

1. In the top-right corner, select Actions → Convert to sub-issue.

2. Specify the key or name of the parent issue, then select it from the list. You can find the key on the issue page, under the title (for example, TEST-1234).

3. Click Save.

Changing the parent issueChanging the parent issue

1. Open the sub-issue page.

2. In the top-right corner, select Actions → Convert to sub-issue.

3. Specify the key or name of the new parent issue, then select it from the list. You can find the key on the issue page, under the title (for example, TEST-1234).

4. Click Save.

Removing the link to a parent issueRemoving the link to a parent issue

To remove the link to a parent issue:

1. Open the parent issue page.

2. In the Related list under the issue description, select the sub-issue the link to which you want to remove.

3. Next to the linked issue, click → Remove link.

Linking a commit to an issueLinking a commit to an issue

You can link an issue to a commit, provided its repository is linked to Tracker.

To link a commit to an issue, specify the issue key in the comment to the commit.

To view the linked commits, select Show the Commits tab in the queue settings. You can view the linked commits:

• In the Commits tab on the issue page.
• On the queue commits page. To switch to the commits page from the queue page, click → Commits in the top-right corner.