• Products
  • Get started
  • Documentation
  • Resources

Link issues, pages, and app content from the issue view

Use links to quickly point to helpful documentation for yourself and others working on your issue. Link issues, pages, and app content using the actions listed just under the issue’s summary (in the issue view):

Link issues in issue view

If there are other issues that relate to the one you’re working on, their details could help add context. By linking two issues together, they will appear on each other’s issue view below the description. Linking issues doesn’t change the issues in any other way. You can either link an existing issue or create a new issue and link it.

Make sure you have the link issues project permission before getting started. Note that your Jira administrator can customize the types of links that you can create.

To link an issue:

  1. Open the issue view of the request.

  2. Click Link issue ().

  3. Search for an existing issue to link, or select + Create linked issue to create a new issue.

  4. If you searched for an existing issue, choose how they relate to each other ("is blocked by" or "relates to," for example), then click Link.

  5. If you created a new linked issue, fill in the issue create form, then click Create.

Annotated view of a search bar for issues with a create linked issue button.
  1. Create linked issue link.

  2. Search for an existing issue.

You can also link any Confluence pages that have information related to the request you’re working on.

You need to have a linked Confluence space to link a page.

To link a page:

  1. Open the issue view of the request.

  2. Click Link page ().

  3. Search for and select the page to link.

  4. Click Link.

Some apps can provide information in ways a description and other details can’t. Diagrams and charts are two common types of content that apps provide, but many other options are available.

Your Jira site needs to have installed Atlassian Marketplace apps to link app content.

To link app content:

  1. Open the issue view of the request.

  2. Click the app’s icon under the issue summary.

  3. Complete the next steps, depending on the app.

If you're a Jira admin, you can find and try new Atlassian Marketplace apps right from the issue view. Click the ••• quick-add button under the issue summary and choose Add apps.

You can add up to 2000 links to an issue. This includes:

  • web links

  • Confluence pages

  • links to an external issue on a different Jira instance

  • links to other Atlassian products.

This does not include child issues.

Additional Help