Issue links

The examples on this page describe how to build a JQL search using JQL Search Extensions.

Links JQL functions

JQL functions are accessible from the Extended Search page or via Extended Search filters in Jira advanced search. When using functions, the issues returned are based on the subquery defined in parentheses.

linkedIssuesOfQuery()

For a given JQL subquery (content in parentheses) and an optional link type, it finds issues linked to resulting issues.

issue in linkedIssuesOfQuery("project=ACME", "is blocked by") finds issues that my project ACME is blocked by
issue in linkedIssuesOfQuery("project=ACME", "blocks") finds issues that project ACME blocks
issue in linkedIssuesOfQuery("type=Epic AND status='To Do'") finds issues that are linked in any way with epics that are in progress

Links JQL keywords

LinksCount

Find issues with a particular number of links. 

Supported operators

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

 

Example

Find issues that have links. 

linksCount > 0

LinkedBy

Find issues that are linked by particular issues. 

Supported operators

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

Example

Find issues that were linked by JQL-3 or JQL-5. 

linkedBy in (JQL-3, JQL-5)

LinksIssue

Find issues with links to a particular issue. 

Supported operators

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

Example

Find issues that link JQL-3 or JQL-5.

linksIssue in (JQL-3, JQL-5)

LinkType

Find issues that have a particular link type. 

Supported operators

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

Example

Find issues that are blocked by another issue.

LinkedIssueStatus

Find issues that are linked or link issues with a particular status. 

Supported operators

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

Example

Find all issues that are linked by issues in the To Do status. 

LinkedIssueStatusCategory

Find issues that are linked or link issues with a particular status category. 

Supported operators

=

!=

~

!~

>

>=

<

<=

IS

IS NOT