Skip to main content
Skip table of contents

Importing Checklists from CSV File to Existing Issues

You can import Local Checklists into existing issues by including the Checklist Text custom field in a CSV file.


  • If you are using Checklist for Jira ENTERPRISE , note that this process cannot import Global Checklists. Global Checklists are not saved to the Checklist Text custom field and therefore will not be imported with the issues.

To import issues and checklists:

  1. Ensure that the Save local checklist items to Jira custom fields global setting is enabled in the the target Jira instance.

  2. Prepare a CSV file, as described in the Jira documentation, that contains (at least) the three columns below:

    1. Issue Key - The destination issue you want to update.

    2. Summary - Leave this field empty. Jira requires that the Summary field be included in any import. Leaving the value empty in the CSV file will ensure that no changes are made to the Summary of the destination issues.

    3. Checklist Text - The checklist you want to import,

      1. In text format with checklist items separated by a newline characters as in the example below.

      2. With “Checklist Text”) should be a column header.

  3. Navigate to Jira settings > System > External System Import.

  4. Select CSV.

  5. Proceed with import.

  6. On the Fields page, select Checklist Text as the corresponding Jira Field for the Checklist Text field in the CSV file, but leave the Map field value checkbox unchecked. This will ensure that to the field values are imported exactly as stored in CSV file.

  7. After the import is complete, the updated issues will have the imported checklists.

JavaScript errors detected

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

If this problem persists, please contact our support.