Configuring issue linking

As a Jira administrator, you can activate issue linking to let your team create links between relevant issues across all Jira applications on your site. Note that all users must have the Link Issues permission before they can link issues.

Adding, editing, and deleting a link type

Clone link types:

We don't recommend editing or deleting clone link types, as they are used to automatically link cloned issues.  


  1. Select the Jira icon (, or ) > Jira settings > Issues.

  2. Click Issue Linking.
  3. Fill in the form below the existing issue links. You can edit the name, outward description, and inward description at any time. 
  4. Click Add.

When you delete a link type, you'll have the option of changing the link (for example, from "Relates" to "Duplicates") or removing all related links. 

Deactivating issue linking

  1. Select the Jira icon (, or ) > Jira settings > Issues.

  2. Click Issue Linking.
  3. A status message indicates whether issue linking is enabled. If issue linking is enabled, click the Deactivate button. The Issue Linking page reloads, stating that linking is disabled.

Configuring the order of linked issues

You can control the order that linked issues are displayed in the Issue Links section by editing the value of the jira.view.issue.links.sort.order property.

  1. Choose the Jira icon (, or ) > Jira settings > System
  2. In General configuration, click Advanced Settings
  3. Click the jira.view.issue.links.sort.order value to edit it. Separate the 'Key', 'type', 'status', 'priority' and 'resolution' values with commas.

You can't do this in the new Jira issue view just yet. Watch The new Jira issue view to get updates about new features we're shipping.

Last modified on Jun 24, 2019

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.