Documentation for JIRA 4.0. Documentation for other versions of JIRA is available too.

Issue linking allows you to create an association between issues. For example:

  • An issue may duplicate another.
  • An issue may incorporate (be a superset of) another.
  • An issue may depend on another.

Within an issue, links to other issues look like this:

The strikethrough text indicates issues that have been resolved, e.g. in the above screenshot, issues JIRA-800, JRA-1186, JRA-1244 and JRA-715 have been resolved, while JRA-652 and JRA-701 have not.

Linking is only available if it has been enabled by your JIRA administrator. To create links between issues, you will also need to have the Link Issues permission in the project(s) to which the issues belong.

To create a link between issues:

  1. View the issue from which you want to create a link.
  2. Click the word 'Link' under the Operations menu in the left-hand column of the screen. The 'Link Issue' form will be displayed. Select the type of link to be created, and the issue(s) to be linked to.
  3. You can link to single or multiple issues. There are two ways to specify the issue(s):
    • Type the full issue key (e.g. ABC-123) - or a comma-separated list of issue keys, if linking multiple issues.
      NOTE: If you have previously browsed an issue, you can find the issue number by:
      • typing the first few letters of the issue key (or part of the Summary), which will display a drop-down list:
      • clicking the 'History' dropdown, at the top right of the page and selecting the issue:

         
        or:
    • Click the 'Select Issue' link to use the 'Issue Selector' popup, which allows you to select either from issues recently viewed, or from issues returned from your chosen saved search filter (click the 'Please select a value' drop-down to choose a saved search filter).
      • To select a single issue, click the issue key.
      • To select multiple issues, click the 'Select multiple issues' link. Checkboxes will appear, enabling multiple issues to be selected:

        Select the issues, then click the 'Select issues' link to close the popup and return to the 'Link Issue' form.
  4. Click the 'Link' button.

To delete a link:

  1. Inside a linked issue, click on the 'Manage Links' link.
  2. In the following screen, click on the small trashcan icon in the bottom-right corner.



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.