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 type] [the name of the link description (inward or outward)])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.
linkedIssuesOf function may provide different results when using the same link names for the issueLinkType alias.linkedIssuesOf demo video
Examples
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 EMPTYThis query helps teams to focus on resolving blocking issues first, ensuring a smoother workflow.
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.