Smart Checklist supports JQL as an approach for searching checklist items values and checklist progress π |
To use this functionality you may need to set up "Checklists" or "Smart Checklist Progress" custom field. It depends on what main criteria you'd like to search for. |
Contents ππ»
π’ Company-managed projects:
π₯ Next-gen projects:
βπΌ NOTE: If you are using the next-gen project, make sure that the added custom fields has a global context. To add global context to your custom fields, follow the official Atlassian guide. |
JQL Search option | JQL query |
---|---|
Issues with opened checklists (not all checklist items completed) |
|
Issues with ALL completed checklists |
|
Issues where there is at least one completed (checked) checklist item |
|
Issues where all checklist items are open (unchecked) |
|
Issues where there is at least one open checklist item |
|
Issues where all checklist items are completed |
|
JQL Search option | You type |
---|---|
Search for checklists containing specific items |
|
Search for an exact phrase in the checklist items or exact checklist items |
|
Search by number of items |
|
βπΌ Note: Available operators could be used: >, >=, <, <=, =, !=. | |
Search by not empty or empty checklists |
or
|
Search by a specified due date |
|
βπΌ Note:
If you are searching for a date: '2022-11-11', it will only match for '2022-11-11', not for '2022/11/11', '11/11/2022' or any other. | |
Search by checklist items in the particular status |
|
βπΌ Note: Use default status (Todo, Done, Skipped, and In Progress) or custom statuses.
|
JQL Search option | You type |
---|---|
Search by currently logged user |
|
Search by any user |
|
βπΌ Note: donβt use β@β symbol | |
Search by custom mention |
|
Operator | JQL Search option | You type |
---|---|---|
AND | Search for not competed checklists with specific number of items |
|
Search for not competed checklists with a specific due date |
| |
Search for not completed checklists which contains specific items |
| |
Search for checklists with mentioned current logged user and due date |
| |
Search for checklists with items in the particular status and due date |
| |
OR | Search for checklists with items in particular statuses |
|
will return checklists that includes items with or statuses | ||
Search for checklists with mentions of current logged user and somebody else |
| |
will return checklists that includes mentions of the current logged user or somebody else |
βπΌ NOTE: If you use combinations of search options (for dates, assignees and statuses) - search will be done for the whole checklist not for the specific checklists items. If checklists items are found based on the search criteria (one contain date, another is in needed status, another has assignee) - the issue will be returned in the search results. |
NOTE: At this moment, searching for Jira issues where a specific checklist item has completed/ incompleted status is unavailable.Β This happens due to the following limitation:Β Jira does not index the special character of - and +.Β
Source:Β https://confluence.atlassian.com/jirasoftwareserver0712/search-syntax-for-text-fields-959315338.html |
Hope everything works for you! π