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 to repository commits.

Adding a link

To link one issue to another:

1. Under the issue description, click  Link to issue.

2. Select an issue to link:

   New issue

   Existing issue

   There are two ways to create a link to a new issue:

   • Under the issue description, click  Link to issue and select the New issue tab. Give your issue a name and press Enter.

   • In the top right corner, select Actions → Add related issue. Fill in the fields the same way as when creating a new issue.

   If you can create an issue in the queue only using a form, you'll see the Select form button on the screen.

   Make sure that you have edit permissions for both issues.

   Select the Existing issue tab, specify the issue's 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 changes to issues.

Creating a sub-issue

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

1. Go to the issue for which you want to add a sub-issue.

2. In the upper-right corner, select Actions → Add sub-issue.

   If you can create an issue in the queue only using a form, you'll see the Select form button on the screen.

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 type

To change an issue's link type:

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

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

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

Removing a link

To unlink an issue:

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

2. In the Related issues list under the issue description, select the issue that you want to unlink.

   Make sure that you have edit permissions for both issues.

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

Creating a sub-issue from an issue

You can make your issue a part of a larger (parent) issue using one of the two methods:

Changing the parent issue

To change the parent issue:

1. Open the sub-issue page.

2. In the Related issues list, next to the parent issue, click →  Change parent issue.

   • To create a new parent issue, select New, name the parent issue, and click Create.
   • To link an existing parent issue, select Existing, specify the parent issue's key or name, and select the issue from the list.

Removing the link to a parent issue

To remove the link to a parent issue:

1. Open the sub-issue page.

2. In the Related issues list, next to the parent issue, click →  Delete Link.

Linking a commit to an issue

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

If you have a repository connected to Yandex Tracker, you can link commits to specific issues. To do this, specify the issue key in the comment on the commit.

To see linked commits, enable this option in the queue settings:

1. In the left-hand panel, click  Queues and select a queue.

2. In the top right corner of the queue page, click  Queue settings.

3. Go to the Integrations tab.

4. Enable the option under Commits.

You can view the linked commits:

• On 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.