Skip to main content
Skip table of contents

Checklist Content YAML (deprecated)

Deprecation Notice and Limitations

  • The Checklist Content YAML field is ignored when multiple checklists are enabled - use Checklist Text instead. When multiple checklists are disabled, Checklist Content YAML stores only items from the default checklist.

  • The Checklist Text field not only allows the same functionality as Checklist Content YAML, but can also store multiple checklists (when enabled) and uses a more user-friendly format. 

  • Checklist Content YAML field may be removed in the future.

  • Checklist Content YAML is not supported in Checklist for Jira ENTERPRISE .


Checklist Text

Checklist Content YAML

Checklist Content YAML

Checklist Content YAML is a multi-line field that holds the content of the local checklist in YAML format. It can be used to read or modify the checklist, e.g. with Jira REST API or external apps.

Checklist Content YAML custom field is automatically kept in sync with the checklist if:

This field can be modified by Jira users.


  • Can be used to Import/export checklists from Trello, CSV or another Jira instance.

  • Can be used with advanced JQL to search for specific contents of a checklist.

  • Can be used when bulk editing to add a checklist to multiple issues.

  • Allows access to the checklist via the Jira API.

  • Can be used to modify a checklist when an issue is edited or transitioned.

  • Records changes to the checklist in the Jira History tab.

  • Can be used with automation or scripting apps to access and/or modify the checklist.

Copying Checklist in YAML Format

You can copy the checklist in YAML format regardless of whether or not the YAML field is on the screen.

To copy the checklist in YAML format:

  1. Click on More … menu of the checklist.

  2. Select Copy checklist as YAML.

How to Find the Custom Field ID

When using custom fields with automation, scripts, etc. you may need the ID number of the custom field.

To find the ID of the custom field:

  1. Log in as a Jira Administrator.

  2. Go to Jira Settings > Issues > Custom fields.

  3. Search for the indicated custom field.

  4. Click the More menu () and select Edit Details.

  5. 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.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.