Automation
Checklists for Jira creates custom fields which can be used with Jira automation to automatically execute Jira actions (i.e. transition an issue) in response to changes on the checklist; or to automatically add or update a checklist in response to changes on a Jira work item.
Sample Automation Rules
Limitations
If an automation rule references the Checklist Text field, the Sync checklists to Custom Fields global setting must be enabled for the rule to function. After enabling the Sync checklists to Custom Fields setting, the sync may take a few hours up to a full day, to complete, depending on the size of your instance. Please allow adequate time before using the field in automation rules.
Jira Service Management currently includes Automation and Legacy Automation. The examples on these pages refer to Automation.
The Default Checklist feature is not compatible with automation rules that use the Issue Created trigger. Both actions depend on Jira’s Issue created notification and an order of operations error may occur.
Copying Checklist Text
If you need a to reference the text of a checklist in an automation rule, copy the contents of the checklist editor.
Using Checklists with Jira Automation Smart Values
Smart values allow you to access and edit Jira data with automation rules. Smart values can be used in both rule conditions and rule actions.
Smart values for issue fields take the form of double curly brackets, “issue” and the name of the issue property you want to access. So {{issue.key}}
returns the issue key and {{issue.summary}}
returns the summary. The smart values for checklist Custom Fields are:
Custom Field | Smart Value | Possible Use |
---|---|---|
Checklist Completed |
|
|
Checklist Progress |
|
|
Checklist Progress % |
|
|
Checklist Text |
|
|
Checklist Text (view-only) |
|
|
You can test that your smart values are correct by setting up a manually triggered rule and using the Log action. After running the rule, you’ll be able to see what the smart value returns in the rule’s audit log.

Learn More About Jira Automation Smart Values:
Finding Custom Field IDs
One of the most common actions you’re likely to use in automation is editing an issue/ work item. When you select the Edit issue action, you’ll be prompted to select the field(s) to be edited from a dropdown list. In the event that the field you are editing is not listed in the dropdown, you can still set its value using JSON. In this case, you will want the Custom Field ID.
To find the ID of the custom field:
Log in as a Jira Administrator.
Go to Jira Settings > Issues > Custom fields.
Search for the indicated custom field.
Click the More menu (…) and select Edit Details.
Copy the URL of the page. The URL will end with the ID number of the custom field.
Custom fields can be duplicated by some errors or rare scenarios. If you are experiencing issues with accessing custom fields, make sure you are referencing the custom field that is currently used by Issue Checklist.
More Jira Automation Resources
Basic Jira Automation Documentation | Advanced Automation Documentation | Other |
---|---|---|