Try it free: ☁Cloud 🖥Data Center

The instructions on this page describe how to execute a JQL search using JQL Search Extensions.

1 Links JQL functions
- 1.1 LinkedIssuesOfQuery
2 Links JQL keywords
- 2.1 LinksCount
- 2.2 LinkedBy
- 2.3 LinksIssue
- 2.4 LinkType
- 2.5 LinkedIssueStatus
- 2.6 LinkedIssueStatusCategory
- 2.7 LinkedIssueType
- 2.8 LinkedIssuePriority
- 2.9 LinksIssuesCount
- 2.10 LinkedByIssuesCount
- 2.11 LinkedByIssueProject
- 2.12 LinksIssueProject

Links JQL functions

JQL functions are accessible from the Extended Search page or via Extended Search filters in Jira advanced search.

LinkedIssuesOfQuery

For a given JQL subquery 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

Search for 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

EXAMPLES

Find issues that have links.

linksCount > 0

LinkedBy

Search for 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

EXAMPLES

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

linkedBy in (JQL-3, JQL-5)

LinksIssue

Search for 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

EXAMPLES

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

linksIssue in (JQL-3, JQL-5)

LinkType

Search 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

EXAMPLES

Find all issues that are blocked by another issue.

LinkedIssueStatus

Search for 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

EXAMPLES

Find all issues which are linked by issues in "To Do" status.

LinkedIssueStatusCategory

Search for issues that are linked or link issues with a particular 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

EXAMPLES

Find all issues that are linked or link issues in status DONE.

LinkedIssueType

Search for issues that are linked or link issues with 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

EXAMPLES

Find all issues that are linked by bugs.

LinkedIssuePriority

Search for issues that are linked or link issues with a particular 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

EXAMPLES

Find all issues that are linked by high-priority issues.

LinksIssuesCount

Search for issues that link to a particular 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

EXAMPLES

Find issues which link more than 5 issues.

LinkedByIssuesCount

Search for issues that are linked by a particular 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

EXAMPLES

Find issues that are linked by more than 10 issues.

LinkedByIssueProject

Search 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

EXAMPLES

Find all issues that are linked by issues from project JQL.

LinksIssueProject

Search for issues that link to 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

EXAMPLES

Find all issues that link to issues from project JQL.