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.

Create links with other issues:

  1. Open the issue to add a link for.

  2. Go to the Links section and tap .

  3. Select an issue to link:

    1. 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.

    2. Select a link type.

    3. Select an issue type.

    4. Click Create.

      A new issue page will open.

    1. If an issue already exists, click Existing. Start typing its key or name, then select the issue from the list.

    2. Select a link type.

    3. 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:

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

  2. 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.

  3. Enter a name for the issue and select the queue where you want to create it.

  4. Select an issue type.

  5. 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.

  1. In the top right corner, click Convert to sub-issue.

  2. Start typing the key or name of the parent issue, then select one from the list.

To change an issue's link type:

  1. Open one of the two linked issues.

  2. Go to Links.

  3. To the right of the linked issue, tap Change link type and choose a new type.

To remove an issue's link:

  1. Open one of the two linked issues.

  2. Go to Links.

  3. To the right of the linked issue, tap and select Remove link.