Links

Links JQL Functions

LinkedIssuesOfQuery

Retrieves issues that are linked to the issues resulting from a specified JQL subquery, with an optional link type.

Examples:

  • issue in linkedIssuesOfQuery("project=ACME", "is blocked by") finds issues that the ACME project is blocked by.

  • issue in linkedIssuesOfQuery("project=ACME", "blocks") finds issues that the ACME project is blocking.

  • issue in linkedIssuesOfQuery("type=Epic AND status='To Do'") retrieves issues linked in any way to epics that are in progress.

Links JQL Keywords

LinksCount

Searches for issues with a specific 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:

  • linksCount > 0 finds issues that have one or more links.

LinkedBy

Finds issues that are linked by particular issues.

=

!=

~

!~

>

>=

<

<=

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:

  • linkedBy in (WERARE-1, WERARE-2) retrieves issues that were linked by issues WERARE-1 or WERARE-2.

LinksIssue

Searches for issues that have links to specific 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:

  • linksIssue in (WERARE-1, WERARE-2) finds issues that link to issues WERARE-1 or WERARE-2.

LinkType

Searches for 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:

  • linkType = "is duplicated by" finds all issues that are duplicated by another issue.

LinkedIssueStatus

Finds issues that are linked to or linked by 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:

  • linkedIssueStatus = "To Do" retrieves all issues that are linked by issues in the “To Do” status.

LinkedIssueStatusCategory

Searches for issues that are linked to or linked by issues in a specific status category.

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:

  • linkedIssueStatusCategory = Done finds all issues that are linked to or linked by issues in the “Done” status category.

LinkedIssueType

Finds issues that are linked to or linked by issues of a particular issue 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:

  • linkedIssueType = Bug retrieves all issues that are linked to or linked by bugs.

LinkedIssuePriority

Searches for issues that are linked to or linked by issues with a specific priority.

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:

  • linkedIssuePriority = "High" finds all issues that are linked to or linked by high-priority issues.

LinksIssuesCount

Searches for issues that link to a specific number of 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:

  • linksIssuesCount > 5 finds issues that link to more than five other issues.

LinkedByIssuesCount

Finds issues that are linked by a certain number of 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:

  • linkedByIssuesCount > 10 retrieves issues that are linked by more than ten issues.

LinkedByIssueProject

Searches for issues that are linked by issues from a particular project.

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:

  • linkedByIssueProject = WERARE finds all issues that are linked by issues from the project WERARE.

LinksIssueProject

Finds issues that link to issues from a specific project.

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:

  • linksIssueProject = WERARE retrieves all issues that link to issues from the project WERARE.