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 instance, an issue may duplicate another, or its resolution may depend on another's.

There are two steps involved in configuring 'Issue Linking'. The first step is configuring JIRA to allow issue links. This is a global setting. The second step is to the create the issue link types required. These are also global.

Step 1: Turning on Issue Linking

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
  3. On the panel on the left, under the title 'Global Settings', click on the link labelled 'Issue Linking'.
  4. You will be shown a status page stating whether linking is enabled. If it is not, click the 'Activate' button.
  5. You will be shown the status page again, this time stating that Issue Linking is enabled.

Step 2: Creating Issue Link Types

  1. On the Issue Linking page there will now be a form titled 'Add New Link Type'.
  2. To create a new link type, say Duplicate, proceed as follows:
    • enter "Duplicate" in the 'Name' text field
    • enter "duplicates" in the 'Outward Link Description' text field
    • enter "is duplicated by" in the 'Inward Link Description' text field
  3. Click the 'Add' button.
  4. This returns to the link type management page, with a new section listing the "Duplicate" issue linking type. Here you can edit or delete the relationship, as required.

Step 3: Linking Issues

  1. To link an issue to another issue, click the link 'Link this Issue to Another Issue' on the 'View' Issue page.
  2. This will bring up the 'Link Issue' form.
  3. Select the link type and enter the key of the issue that you want to link to. It is also possible to link to multiple issues. You can optionally add a comment.
    Click on the 'Link' button.
  4. You will see the issue page again, with a new section listing the issues that are linked to this issue



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.