Issue links
The examples on this page describe how to build a JQL search using JQL Search Extensions.
On this page: |
---|
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 (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 byissue in linkedIssuesOfQuery("project=ACME", "blocks")
finds issues that project ACME blocksissue 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 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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