View Source

This JQL function returns issues that are linked to any issue that is returned by a JQL subquery.

Additionally you can further refine your query by specifying distinct link types and even a minimum number of linked issues.

linkedTo(subquery) #Output: Issue list

Parser expression

Description

issue in linkedTo('project = "Asset Management" and type = Employee')

This example returns all issues linked to the Employees tracked in the Asset Management project.

issue in linkedTo('issuetype = Task and priority = Blocker')

This example returns all issues that are linked to a Task with priority set to Blocker.

Parameters used in this function

Parameter	Input (data type)	Description
`subquery`		A JQL query to select the issues that are linked to the those issues you want to be returned.

This function returns an

Variant where you can additionally limit the results by specifying certain link types.

linkedTo(subquery, linkTypes) #Output: Issue list

Parser expression

Description

issue in linkedTo('project = "Asset Management" and type = "Employee"',"has asset")

This example returns all issue linked to the Employees tracked in the Asset Management project via the "has asset" link type.

issue in linkedTo('issuetype = Task and priority = "Blocker"', "is blocked by, causes")

This example returns all issues that are linked to a Task with priority set to Blocker either by the "is blocked by" or "causes" link type .

Parameters used in this function

Parameter	Input (data type)	Description
`subquery`		A JQL query to select the issues that are linked to the those issues you want to be returned.
`linkTypes`		The link type or link types that must have been used to link to the desired target issues. The list of link types should be a comma-separated list.

This function returns an

Variant where you can additionally specify a minimum number of linked issues.

linkedTo(subquery, linkTypes, minimumLinked) #Output: Issue list

Parser expression

Description

issue in linkedTo('project = "Asset Management" and type = Employee',"has asset",2)

This example returns all issue linked to the Employees tracked in the Asset Management project via the "has asset" link type.

In order to be returned by the query each Employee must have at least two of those linked issues.

issue in linkedTo('project = "Asset Management" and type = PC',"belongs to",2) AND type = Employee

This example returns all Employees that have a PC associated within the Asset Management project, that is also associated with another person.

Parameters used in this function

Parameter	Input (data type)	Description
`subquery`		A JQL query to select the issues that are linked to the those issues you want to be returned.
`linkTypes`		The link type or link types that must have been used to link to the desired target issues. The list of link types should be a comma-separated list.
`minimumLinked`		A natural number larger than 0.

This function returns an

Use cases and examples

Short description	Returns issues linked to other issues satisfying a JQL subquery.
Output
Label

	Status
Tech review
Style guide