...
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
Links JQL functions
| Info |
|---|
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 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
Search for issues with a particular number of links.
SUPPORTED OPERATORS Supported operators
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLESExample:
Find issues that have links.
| Code Block |
|---|
linksCount > 0 |
...
LinkedBy
Search for issues that are linked by particular issues.
SUPPORTED OPERATORS Supported operators
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLESExample:
Find issues that were linked by JQL-3 or JQL-5.
| Code Block |
|---|
linkedBy in (JQL-3, JQL-5) |
...
LinksIssue
Search for issues with links to a particular issue.
SUPPORTED OPERATORS Supported operators
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLESExample:
Find issues that link JQL-3 or JQL-5.
| Code Block |
|---|
linksIssue in (JQL-3, JQL-5) |
...
LinkType
Search for issues that have a particular link type.
SUPPORTED OPERATORS Supported operators
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLESExample:
Find all issues that are blocked by another issue.
| Code Block |
|---|
linkType = "is blocked by" |
...
LinkedIssueStatus
Search for issues that are linked or link issues with a particular status.
SUPPORTED OPERATORS Supported operators
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLESExample:
Find all issues which are linked by issues in "To Do" status.
| Code Block |
|---|
linkedIssueStatus = "To Do" |
...
LinkedIssueStatusCategory
Search for issues that are linked or link issues with a particular status category.
SUPPORTED OPERATORS Supported operators
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLESExample:
Find all issues that are linked or link issues in status
| Status | ||||
|---|---|---|---|---|
|
| Code Block |
|---|
linkedIssueStatusCategory = Done |
...
LinkedIssueType
Search for issues that are linked or link issues with a particular issue type.
SUPPORTED OPERATORS Supported operators
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLESExample:
Find all issues that are linked by bugs.
| Code Block |
|---|
linkedIssueType = Bug |
...
LinkedIssuePriority
Search for issues that are linked or link issues with a particular priority.
SUPPORTED OPERATORS Supported operators
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLESExample:
Find all issues that are linked by high-priority issues.
| Code Block |
|---|
linkedIssuePriority = "High" |
LinksIssuesCount
Search for issues that link to a particular number of issues.
SUPPORTED OPERATORS Supported operators
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLESExample:
Find issues which that link more than 5 issues.
| Code Block |
|---|
linksIssuesCount > 5 |
...
LinkedByIssuesCount
Search for issues that are linked by a particular number of issues. SUPPORTED OPERATORS
Supported operators
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLESExample:
Find issues that are linked by more than 10 issues.
| Code Block |
|---|
linkedByIssueCount > 10 |
...
LinkedByIssueProject
Search for issues that are linked by issues from a particular project.
SUPPORTED OPERATORS Supported operators
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLESExample:
Find all issues that are linked by issues from project JQL.
| Code Block |
|---|
linkedByIssueProject = JQL |
LinksIssueProject
Search for issues that link to issues from a particular project.
SUPPORTED OPERATORS Supported operators
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLESExample:
Find all issues that link to issues from project JQL.
...