Breadcrumbs

linkedIssues()

Current issue

This function returns the list of issues linked to the specified issue(s), including Epic-Task links.

Bash
linkedIssues() #Output: Issue list

Examples

Parser expression

Description
Bash
linkedIssues()

This example returns an issue list with all issue linked to the current issue.
Bash
distinct(linkedIssues() EXCEPT linkedIssues("has Epic, is Epic of"))

This example returns an issue list of all the issues linked to current issue, excluding Epic issue links.

To achieve this, the following functions are used:

Output

This function returns an issue list

An issue appears in the output as many times as it is linked to the current issue.

Function distinct() can be used to remove duplicated issues.

Variant where you additionally can define issue link types.

Bash
linkedIssues(linkTypes) #Output: Issue list

Examples

Parser expression

Description
Bash
linkedIssues("blocks, clones")

This example returns an issue list of all the issues linked with the current issue using issue link types blocks or clones.

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

linkTypes

text

Comma-separated list of issue link type names, or an empty text ("") for representing all issue link types, i.e., linkedIssues("") is equivalent to linkedIssues() .

Output

This function returns an issue list

Variant where you additionally define issues.

Bash
linkedIssues(linkTypes, issueList) #Output: Issue list

Examples

Parser expression

Description
Bash
linkedIssues("", subtasks())

This example returns an issue list of all issues linked to the current issue's sub-tasks using any issue link type.

To achieve this, the following functions are used:
Bash
linkedIssues("clones, duplicates", subtasks())

This example returns an issue list of all issues linked to the current issue's sub-tasks using the link type "clones" or "duplicates".

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

linkTypes

text

Comma-separated list of issue link type names, or an empty text ("") for representing all issue link types, i.e., linkedIssues("") is equivalent to linkedIssues() .

issueList

issue list

Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).

Duplicated issues are ignored.

Output

This function returns an issue list

Variant where you define issue keys instead of issues.

Bash
linkedIssues(linkTypes, issueKeys) #Output: Issue list

Examples

Parser expression

Description
Bash
linkedIssues("", %{parent.key})

This example returns an issue list of all issues linked to the current issue's parent using any issue link type.

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

linkTypes

text

Comma-separated list of issue link type names, or an empty text ("") for representing all issue link types, i.e., linkedIssues("") is equivalent to linkedIssues() .

issueKeys

text

Comma-separated list of issue keys. Duplicated issue keys are discarded. Optionally you can use field codes returning issue keys.

Output

This function returns an issue list

📚 Use cases and examples