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

About Issue Linking

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. New installations of JIRA come with four default types of links:

  • "relates to" / "relates to"
  • "duplicates" / "is duplicated by"
  • "blocks" / "is blocked by"
  • "clones" / "is cloned by" (this is used when issues are cloned)

You can add, edit or delete link types to suit your organisation, as described below.

(info) 注意:

  • Your users must have the Link Issues permission before they can link issues.
  • Issue linking must be enabled in order for your users to be able to link issues. Issue linking is enabled by default. If your organisation does not require the ability to link issues, you can disable it globally for all users as described below.

On this page:

Adding a Link Type

To create a new link type, e.g. "Causes":

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Select 'Administration' > 'System' > 'Issue Features' > 'Issue Linking' (tab) to open the 'Issue Linking' page as shown in the screenshot below.
    (tick) Keyboard shortcut: 'g' + 'g' + type 'issue l'
  3. ページの最後にある「新しいリンク タイプの追加」フォームに：
    • Enter "Causes" in the 'Name' text field.
    • Enter "causes" in the 'Outward Link Description' text field.
    • Enter "is caused by" in the 'Inward Link Description' text field.
  4. 「追加」ボタンをクリックします。
  5. This returns to the 'Issue Linking' page, with a new section listing the "Causes" link type.

Screenshot: the "Issue Linking" administration page

Editing or Deleting a Link Type

(info) It is recommended that you do not edit or delete the 'Clones' link type, as this is used to automatically link issues when they are cloned.

リンク タイプを編集または削除する方法は次のとおりです。

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Select 'Administration' > 'System' > 'Issue Features' > 'Issue Linking' (tab) to open the 'Issue Linking' page as shown in the screenshot above.
    (tick) Keyboard shortcut: 'g' + 'g' + type 'issue l'
  3. Locate the link type you wish to edit or delete, and click the link type's associated 'Edit'/'Delete' link in the 'Operations' column.

Disabling Issue Linking

To disable issue linking for your entire JIRA site, for all users:

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Select 'Administration' > 'System' > 'Issue Features' > 'Issue Linking' (tab) to open the 'Issue Linking' page as shown in the screenshot above.
    (tick) Keyboard shortcut: 'g' + 'g' + type 'issue l'
  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.



See our Getting Help page for details.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

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