linkedIssuesOf

This function helps you find all issues linked to those identified by a specific query. It is particularly useful for:

  • Identifying dependencies between tasks

  • Highlighting blockers

  • Enhancing visibility across linked issues

For more information on how to configure JQL queries, see the Atlassian Advanced Searching documentation.

Syntax and parameters

linkedIssuesOf(Subquery, [link name])

  • Subquery: A JQL query to find the issues of interest. This query should be enclosed in double quotes.

  • Link name: The type of link between issues (e.g., "blocks", "is blocked by"). If omitted, the function searches across all link types, which we only recommend if you are not looking for a specific link type.

The issues returned when using link names such as 'blocks' and 'is Blocked by', or 'clones' and 'is Cloned by', in the linkedIssuesOf function may provide different results when using the same link names for the issueLinkType alias.

linkedIssuesOf demo video

Examples

  1. Finding unresolved issues blocked by open issues:

    To identify unresolved issues that are blocked by issues in the Open state, you can use the following query:

    issueFunction in linkedIssuesOf("status = Open", "blocks") AND resolution IS EMPTY

    This query helps teams to focus on resolving blocking issues first, ensuring a smoother workflow.

  2. Searching for linked issues without specifying a link type:

    If you need to find all linked issues regardless of the link type, you can use a query like:

    issueFunction in linkedIssuesOf("resolution = unresolved")

    This broader query is useful for gaining a comprehensive view of all dependencies.

  • Define clear link types: Specify the link type in your query to narrow down results and focus on the most relevant dependencies.

  • Use with other functions: Combine linkedIssuesOf with other JQL functions for more complex queries. For example, integrate it with epicsOf to see how linked issues relate to larger epics.

On this page