Issue linking allows you to create an association between two 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:
Screenshot: the 'Issue Links' section within an issue
Note that resolved issues will be shown in strike-through font, e.g. DEMO-1.
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. |
On this page:
Creating a link
To create a link between issues:
- View the issue from which you want to create a link.
- 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.
- You can link to single or multiple issues. There are two ways to specify the issue(s) in the Issues field:
- 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:
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.
- Click the 'Link' button.
Deleting a link
To delete a link:
- Go to an issue that contains links, and locate the 'Issue Links' section (see screenshot at top of page).
- Click the 'Manage Links' (eye) icon.
- In the following screen, click on the small trashcan icon in the bottom-right corner:
Searching for linked issues
You can search for issues that are linked to a particular issue. For details, please see the documentation on Advanced Searching.