Skip to main content
Skip table of contents

Exporting checklist data for a Cloud Import

You need administrator rights in Jira to perform the tasks on this page.

As of March 2022, the preferred approach to import to Cloud is to use Checklist for Jira | Enterprise Cloud. Please read the Cloud Migration Instructions before continuing.

Checklist offers a migration path for users who want to move from a Server instance to a Cloud instance.

Each Checklist custom field context must be exported separately and must be imported in the Cloud version.

Before you begin

  • Ensure that you have the latest version of Checklist installed or at least version 5.2.4, which contains numerous bug fixes and improvements.

  • Read App Comparison, as migrating to Cloud comes with a number of limitations that you should be aware of before proceeding.

  • For each Checklist custom field context that you want to transfer, if the context is marked “All Projects”, check whether it really is required for all projects or not. Custom fields will often have an All Projects context that only ends up applying to certain projects due to the screens on which it can appear. The issues in which the custom field does not appear will still save global items to the database, which can lead to a lot of useless data that will take time to transfer to the Cloud. By limiting the custom field context to specific projects, this extra data will not be transferred, resulting in a smoother import process.

  • If you are doing a step-by-step migration, you can select only the projects that you want to export. This will not only minimize the data to import, but also prevent errors that would occur if you exported data from projects that have not yet been migrated to Cloud. This only applies if your custom field context already has projects; if it’s set to “All Projects”, a partial migration is not recommended.

Exporting a custom field context from Server

Before Checklist v6.2.0, this feature was disabled by default and had to be enabled before you could proceed with exporting your data. In case you still have a version prior to 6.2.0 installed, you will find the procedure to enable the export feature below. If you have version 6.2.0 or later installed, you can skip to Exporting a custom field context.

Enabling the Checklist Export Feature Action module


  • Go to Administration > Manage apps.

  • In the sidebar, go to Atlassian Marketplace > Manage apps.

  • Click on Checklist to expand the app details.

  • Click on [X] of [X] modules enabled to see all the enabled modules (these numbers will be different for everyone).

    Locate the Checklist Export Feature Action module, hover over Disabled, and click the Enable button that appears.

Exporting a custom field context

Each custom field context must be exported separately.

  1. Go to Administration > Issues.

  2. In the sidebar, go to Fields > Custom fields.

  3. In the Actions column, click the menu icon for a specific Checklist custom field and click Configure.

  4. Scroll to the context you wish to export and click Export.

  5. The Checklist Export page that appears will display the destination path and file name of the exported files. To begin the process, click Export. You can also select specific projects to export in case you want to perform a partial migration.

  6. Once the export is complete, a success message will be displayed.

If no file was created, it may be due to an issue with the read/write permissions on the destination folder. You can find more details about the error message in your Jira log file or console.

If you are unable to resolve the issue yourself, please contact our Service Desk.

JavaScript errors detected

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

If this problem persists, please contact our support.