Combining checklists with automation and workflow behaviors opens up a world of possibilities for automating and streamlining processes. You can:
- Automatically close an issue when a checklist is completed
- Replace checklist items when an issue transitions to a new status
- Reset a checklist daily
- Clear a checklist when an issue is transitioned
- Mark all checklist items complete when an issue is transitioned
- Validate that all checklist items are complete before an issue can be transitioned
But what if you want to perform operations on or validate for a specific checklist item, rather than the checklist as a whole?
This is where Regex comes into the picture. Using Regex allows you to match for exact text, or a defined range in any string. You can use Regex to check for the specific text of a checklist item, or a checklist custom status. Here's some examples of how you can use regular expressions with checklists in Jira.
What is Regex?
Regex, also known as Regular Expressions or Regexp, is a set of characters that can be used to define a search pattern in text. These patterns can be used to find text in a string, to validate input, etc. For example, given a list of file names, you could use Regex to identify only those that have a “.pdf” extension. Or you could validate that a date or a phone number in a text field is formatted correctly.
Regex is a powerful tool. However, it is not easily readable or particularly intuitive. Therefore it’s good to have a few resources available when you’re learning Regex:
- RegexLearn includes a detailed tutorial, a cheat sheet, and a playground where you can practice/test your regular expressions
- QuickRef.Me has a nicely formatted Regex cheat sheet
- Regex 101 provides a great environment for developing and testing Regex
- Generative AI tools, including the Atlassian Intelligence available in Confluence Premium and Enterprise, can create Regex expressions for you
How Can I Use Regex in Jira?
There are four places where you are likely to use regular expressions in Jira:
- Checklists
- Automation rules
- JQL
- Workflow validators
Using Regex with Checklists
Using regex with checklists allows you to identify:
- A custom checklist status
- A specific checklist item
- A specific checklists (when multiple checklists are used on one issue)
Here are some examples of using regular expressions with Jira checklists.
Change Status of Checklist Items to Custom Status
You can use the replaceAll function with Regex to transition checklist items to a custom status. In this case, an automation rule accessed the Checklist Text custom field to change the status of all checklist items to “Deployed” when the issue was transitioned.
.png)
Validate for a Specific Checklist Item
You can use the Regex validator to check that a specific checklist item is complete. The examples below will work with both simple checkboxes and item statuses.
- To check that a checklist item called first item is complete
- To check that two items, called first item and second item are complete
- To check that an item in a given position (4th) on the list is complete
The example above will block the transition if the fourth item in the list is incomplete. To block transition if Nth item is incomplete, change the 3 in the expression above to N - 1.
Note that this expression cannot be used to validate for the first item in the list, and that the list must contain at least N items. If you want to validate for more than one position in the list, you will need to create separate validators for each position.
- To check that there are no items in an Open status
The following regular expressions can be used to make the transition require at least one checked item, and optionally to require that checklist has at least one item. The expressions can work with or without statuses. If you use custom statuses, you will need to adjust the expressions.
Validate that a Particular Checklist has a Minimum Number of Items
In this case, a team was using multiple checklists on development issues. They used a Definition of Ready checklist that was added to stories by default. Later they added an Acceptance Criteria list. A Regex validator blocked the issue from being transitioned to the QA status unless the Acceptance Criteria list was present and had at least three items:
Transition Issue when Items on a Given Checklist are Complete
These expressions are useful if you have multiple checklists on a single issue.
- Check that all items on a given checklist are complete
- Check that all mandatory items on a given checklist are complete
Using Regex with Jira Automation
The Advanced Compare Condition in Jira automation allows you to check for text that either contains, or exactly matches a regular expression.
Using Regex in a Jira Workflow Validator
You can also use Regex in a Jira validator to block a transition unless he contents of a given field exactly match your expression.
Performing a JQL Regex Search
So can you use Regex with JQL to find Jira issues? Not with out-of-the -box Jira – at least not yet.
I was curious if the new AI-powered search would accept a Regex expression, so I did an experiment.
First I asked Confluence to write the expression for me:
Then I created some test issues and asked the AI search to find them:
So far, so good. But then I tried to add the Regex to the search request. I got an error:
I also tried giving the search AI the same instructions I gave Confluence when I asked it to write the Regex. No luck:
So for the moment, if you want to use JQL Regex, you’ll need to get some help from the Marketplace.
These are just a few examples of how you can use the powerful combination of Checklists and Regular Expressions in Jira. See the automation section of our documentation for more ideas.
