We have a new documentation site. Please go here to see the latest.

Importing Checklists – Multiple Jira Instances

Owned by Jennifer Choban
Last updated: Feb 06, 2024

 

Importing Checklists Between Jira Cloud Instances

You may be able to performa a single Jira-Jira migration, so issue and project IDs do not change. Please confirm with Atlassian support if your instance is qualified (if issue IDs will stay the same). Then contact our support team to have the checklist data moved between instances on a database level.

If your instance does not include JSM or Team-managed/Next-gen projects, you may want to use o use Atlassian’s Cloud Migration tool, currently in Beta, as described here, as an alternative to the instructions on this page.

Limitations

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

  • Templates are not migrated in the process described here and will have to be added manually. If you have a large number of templates and are performing a single Jira-Jira migration (so project IDs did not change), please contact us for assistance. 

  • Merging Multiple Jira Cloud instances is often performed by temporarily moving all issues to a server instance, in which case all issue IDs will be changed. Follow the process below to ensure that checklist data is preserved/merged into the new destination instance.

Source Jira Cloud Instance

  1. Enable the Save local checklist items to Jira custom fields global setting. This will ensure that all checklist data will be stored in Jira custom fields and migrated automatically with the other Jira data. Note that the initial save might require a few hours if the setting was previously disabled.

  2. Export the issues from Jira to a CSV file using the Backup Jira method. Checklist data will be preserved in the Checklist Text field.

Target Jira Cloud Instance

  1. Install Issue Checklist if it is not already installed.

  2. Ensure that the Save local checklist items to Jira custom fields global setting is enabled.

  3. Find and note the custom field ID of the Checklist Text field.

  4. Import the Jira data using the External System Import wizard. This will create checklist custom fields. 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.

     

  5. The Checklist Text field will now be populated with data from the import. However, an automation rule needs to be run in order to re-sync the Checklist Text field with the UI. Go to Project Settings > Automation and click Create rule.

  6. Create an automation rule:

    1. Trigger: Select Scheduled.(The scheduled time does not matter – the rule will be manually ran once and then disabled.) Check the Run a JQL search and execute actions for each issue in the query checkbox and enter an expression that returns the imported issues (ex: project = AK AND key > AK-10 AND key < AK-24 ).

    2. Action – Edit issues, select Checklist Text as the field to be updated and enter (where 10039 is the custom field ID of the Checklist Text field.

      {{issue.customfield_10039}} ---

    3. Save and Run the rule.

    4. After confirming that the issues were updated, disable the rule.