Searching checklists
- Paige Wergeland (Unlicensed)
- Pascal Perreault [Okapya]
- Maxime Lefebvre
To find particular checklists or checklist items, you can use Jira's powerful search feature.
Using Jira’s built-in search tool
Using Jira’s built-in basic searching, you can search for specific text or fields. With advanced searching, you can create JQL queries using more advanced functions.
For more information, see Basic Searching and Advanced Searching in the Atlassian Jira documentation.
To access the search tool:
In the header, go to Issues > Search for Issues.
Enter search text in the Contains text field, or click Advanced to enter an advanced search.
Searching checklists using special JQL functions
With Checklist, you also have access to additional search functions to help you find checklists or checklist items that meet advanced criteria.
In the Advanced search bar, a list of possible functions will pop up as soon as you start typing. For details about all the special functions that are available, see the sections below. And remember — if you are searching for text that contains more than one word, make sure to enclose it in double quotes ("")!
If these special functions do not appear, your installation may not have Checklist Searcher set as the search template. For more information, see Making checklists searchable.
allItemsChecked()
Returns the checklists that have all their items checked (or not).
Operators | Example |
|---|---|
= |
|
!= |
|
This alternative returns the checklists in which a particular section has all its items checked (or not).
Operators | Example |
|---|---|
= |
|
!= |
|
Section heading filters are case sensitive and must include all Markdown syntax.
allItemsUnchecked()
Returns the checklists that have all their items unchecked (or not).
Operators | Example |
|---|---|
= |
|
!= |
|
This alternative returns the checklists in which a particular section has all its items unchecked (or not).
Operators | Example |
|---|---|
= |
|
!= |
|
Section heading filters are case sensitive and must include all Markdown syntax.
allMandatoryItemsChecked()
Returns the checklists that have all their mandatory items checked (or not).
Operators | Example |
|---|---|
= |
|
!= |
|
This alternative returns the checklists in which a particular section has all its mandatory items checked (or not).
Operators | Example |
|---|---|
= |
|
!= |
|
Section heading filters are case sensitive and must include all Markdown syntax.
checklistCompletion(%)
Returns the checklists that fall within a particular percentage range in terms of completion.
Operators | Example |
|---|---|
< |
|
> |
|
<= |
|
>= |
|
This alternative returns the checklists in which a particular section falls within a particular percentage range in terms of completion.
Operators | Example |
|---|---|
< |
|
> |
|
<= |
|
>= |
|
Section heading filters are case sensitive and must include all Markdown syntax.
itemAssignedToMe()
Returns the checklists in which an item is assigned to you.
Operators | Example |
|---|---|
= |
|
itemDueDate()
Returns the checklists in which an item is due on a particular date or within a particular time range.
Only the ISO date format is supported.
Operators | Example |
|---|---|
= |
|
< |
|
> |
|
<= |
|
>= |
|
itemSearch()
Returns the checklists in which an item meets the specified criteria.
Operator | Fields | Description | Example |
|---|---|---|---|
= |
| The user to whom the item is assigned. |
You can use the |
| The completion status of the item. |
| |
| The due date of the item, either as a specific date or a length of time in relation to today’s date. |
| |
| The name of the item. |
Name filters are case sensitive and must include all Markdown syntax. | |
| The priority of the item. |
| |
| The status of the item. |
| |
| The item’s section heading. |
Section heading filters are case sensitive and must include all Markdown syntax. |
You can string multiple criteria together using commas. For example, the following returns all issues in which at least one item in the checklist meets all three criteria:
DoD = itemSearch("name = Submit work", "dueDate = 2010-05-01", "assignee = ")
Although this functions as an “AND”, the itemSearch() function is different than combining JQL functions with the AND operator. Using the AND operator searches for entire checklists that meet all the criteria, while itemSearch() searches for individual items that meet your criteria.
SERVER documentation (On Cloud? Go here.)
Have questions? Contact our Service Desk for help anytime.