We have a new documentation site. Please go here to see the latest.
Search advanced with JQL
- Jack (Hunter) Jaroczynski
- Andres Hevia
- Maciej Opala (Deactivated)
- Jennifer Choban
Issue Checklist provides Checklist Text field, which can be used to build advanced search queries.
It allows users to search for issues in Basic or Advanced-JQL mode for item text and item status. Read more about issue search in JIRA.
There is also Basic Search functionality available.
Prerequisites
"Save checklist data to Jira custom fields" option enabled in Global Settings.
Examples
Following JQL examples can be combined with any other JQL clauses. Read more about advanced search and JQL in JIRA.
Search for all issues with an empty checklist (no items):
"Checklist Text" is EMPTY
Search for all issues with an item containing "abc" word:
"Checklist Text" ~ "abc"
Search for all issues with items in "Skipped" status (statuses must be enabled):
"Checklist Text" ~ "\\[skipped\\]"
Search for all issues containing checklist item with given user mention:
"Checklist Text" ~ "\"@b0926e6a-bbb4-460e-a2c5-37811d\""
Please note that that the "b0926e6a-bbb4-460e-a2c5-37811d" is an Atlassian Account ID for a user. Read how to find user account ID.
It is possible to quickly see items with given user mentions through the Assigned Items page.
Display "My items" on the Jira Dashboard
It is possible to save the JQL as a filter in Jira and then display the results of an issue filter on the Jira Dashboard using "Filter Results Gadget".
Search for all issues with an item "abc" that is checked (item is completed). This example assumes that Statuses are not enabled in Global Settings.
"Checklist Text" ~ "\\[x\\] abc"
Due to Jira bug, this query and the ones below (searching for an exact term) do not work as expected. Please vote for a fix at JRACLOUD-21372
Search for all issues with an item "abc" that is unchecked (item is not completed). This example assumes that Statuses are not enabled in Global Settings.
"Checklist Text" ~ "\\[\\] abc"
Search for all issues with an item "abc" that is checked (completed) and item "def" that is unchecked (not completed). This example assumes that Statuses are not enabled in Global Settings.
"Checklist Text" ~ "\\[x\\] abc" and "Checklist Text" ~ "\\[\\] def"