Retrieve Linked Work Items by Link Type in Jira Cloud

Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.

Summary

Learn how to find all work items with a specific work item link type using JQL (Jira Query Language).

Solution

Find the issues using two options:

Option 1

  • To display the work items, use the JQL below

    project = <projectname> AND issuetype = <workitemtype> AND issueLinkType in ("Child Link", "<linktypename>")
  • Specify the LinkType by name <linktypename>

  • Replace the Placeholders <projectname> and <workitemtype> as needed in your environment

  • This will display all parent work items that have the LinkType <linktypename> and are part of the project <projectname>

Step 2

  • To display only the linked work items of a particular LinkType <linktypename> run this JQL

    issue in linkedIssues("<workitem-key>", '<linktypename>') OR issue in linkedIssues("<workitem-key>", '<linktypename>')
  • Replace the Placeholders <linktypename> and <workitem-key>. Example Work Item Key SPRIN-6

  • Currently, Jira requires you to include all parent work items in the JQL using the OR keyword to display linked work items directly.

Enhanced search

Enhanced search and retrieval of issueLinkType are possible with Adaptavist (Scriptrunner for Jira) and other third-party tools.

Updated on April 29, 2025

Still need help?

The Atlassian Community is here for you.