Skip to main content
Skip table of contents

Import

The Import global setting page is used for importing checklists from other apps. See this page for information about importing checklists from custom fields or other Jira instances.

Smart Checklist Import (Server and Cloud)

This import process reads all checklist items created by the Smart Checklist app (stored in your Jira Cloud) and copies them to Checklists for Jira (Enterprise) as local checklists. If you want to migrate from Smart Checklist for Jira Server, you must migrate your data to Jira Cloud first.

Note that currently we can only match to our default statuses - Open, In Progress, Done, and Skipped during the import. If custom statuses have been configured, the import will mark all of the not matched statuses as either Open (for unchecked items) or Done (for checked items).

  1. Navigate to Jira Settings > Apps and select Import under the Checklist for Jira heading.

  2. Select the Smart Checklist tab.

    SmartTab.png

  3. Determine if you want to overwrite or append to existing checklists. The import process is designed to allow for incremental imports, and does not prevent duplicates. If you perform an import without enabling Overwrite existing items, any previously imported items may appear as duplicates in subsequent imports.

    Use the Overwrite existing items in Checklists for Jira Enterprise toggle to indicate if you want to:

    • Overwrite existing data (Toggle enabled)
      If the toggle is enabled, the import process will replace any existing checklists (in Checklists for Jira Enterprise) with the data being imported from Smart Checklist. In cases where there is an existing checklist in Checklists for Jira Enterprise, and the corresponding issue/work item does not have a checklist in Smart Checklist for Jira, the existing checklist in Checklists for Jira Enterprise will be preserved. It is recommended that you enable the toggle if you attempt to perform an import more than once.

    • Append imported checklist items to already existing checklists (Toggle disabled)
      Imported checklist items will be appended to the existing checklists on the issue/work item.  

  4. Click Start import. The import will be scheduled and a gray panel will show the import status.
    Click on the Refresh icon to update the status.

    Sched.jpg
  5. The Import status will change when the background import process is launched. Once the process begins, the import cannot be canceled.

    Run.jpg

  6. When the import is complete, the status panel will turn green and will display the number of checklist items and issues/work items impacted.

Complete.jpg

Checklist for Jira Import (Server)

Migrating from On-prem to Checklist for Jira Enterprise
  1. Install Checklist for Jira Enterprise.

Before you start:

  • Jira will not be impacted by the migration. However, there will be some downtime during which you will not be able to access your checklist data.

  • The importer for Checklist for Jira on-prem is available in Checklist for Jira Enterprise and will load all checklist data files created by the Checklist for Jira Export feature and copy them to the Checklist for Jira Enterprise app.

  • Checklist for Jira | Enterprise works differently than Checklist for Jira Server/DC. Learn more here.

  1. Use the Checklist for Jira Export feature to generate the files that will be loaded into Issue Checklist.

  2. Navigate to Jira Settings > Apps and select Import under the Checklist for Jira | Enterprise heading.

  3. Select the Checklist for Jira Server/DC tab.

  4. Locate the files generated during the Checklist for Jira Server export process and drag them to the upload area. Alternatively, you can also click the area and select the files from your computer.

  5. When all the files generated during the Export process are in the list, click Upload files.

  6. Determine if you want to overwrite or append to previously imported checklists. The import process is designed to allow for incremental imports, and does not prevent duplicates. If you perform an import without enabling Clear previously imported data, any previously imported items may appear as duplicates in subsequent imports. Use the Clear previously imported data toggle to indicate if you want to:

    • Clear previously imported data (Toggle enabled)
      Replace any previously imported data from Checklist for Jira on-prem with the items being imported from the currently uploaded files. It is recommended that you enable the toggle if you attempt to perform an import more than once. Data to be replaced includes:

      • Global Checklists

      • Checklist items in Jira issues (global and local)

      • Checklist item statuses

        Please see the troubleshooting imports page for more information.

    • Append imported checklist items to already existing checklists (Toggle disabled)
      Imported checklist items will be appended to the existing checklist(s) on the issue. If you will import the same checklist Checklist Field but for other project(s), duplicate Global Checklist will appear. It’s recommended to import a checklist Custom Field configuration for all projects at once.

  7. Once the files are uploaded, and you’ve confirmed that the Clear previously imported data toggle is in the correct position, click Start import. The import will be scheduled and a gray panel will show the import status. Click on the Refresh icon to update the status.

  8. When the import is complete, the status panel will turn green and will display the number of checklist items and issues impacted.

The import is a gradual process. Checklist data will become available in the database and visible in the UI as it’s imported. However, we recommend waiting to work on checklists until the import is finalized.

If you need to cancel and restart the import, be sure to enable the Clear previously imported data in Checklist for Jira Enterprise toggle.

Please contact our support with any questions.

Note that in the Cloud App, global and local items are separated into two different checklists: an issue that had a checklist with both global and local items in the on-prem version will have two different checklists (global and local) in the Cloud version.

Checklist for Jira Import (Cloud)

Upgrading from Checklist for Jira Cloud to Checklist for Jira Enterprise
  1. Log in as an administrator and navigate to Jira Settings > Apps > Manage Apps.

  2. The Checklist for Jira app will have an Update button.

image (9).png
  1. Click on Checklist for Jira to see a description of the update.

image (8).png
  1. Click Update.

  2. Click Accept & update to confirm the update. (The Act on a Jira user’s behalf permission is only used for to avoid automatic upgrading.)

  3. You will see a confirmation message.

    image-20240209-173619.png

  4. The app description will refresh. Click on the Get Started button.

    image (6).png

  5. To migrate your checklist data to the new app, click Start import. If you are migrating for the first time, you can ignore the Clear previously imported data toggle.

    Clear.png

If you need to cancel, then restart the import at a later time, enable the Clear previously imported data in Checklist for Jira Enterprise toggle. This will delete in any previously imported data to prevent checklists/items.

  1. A message will indicate that the import is scheduled and allow you to cancel the import if needed.

    Scheduled.png

  2. The import should start within a few minutes. You can check that the import is underway by clicking the Refresh button. Once the import is started, the Cancel import button becomes disabled.

    Running.png

The import is a gradual process. Checklist data will become available in the database and visible in the UI as it’s imported.

If you need to cancel and restart your import, be sure to enable the Clear previously imported data in Checklist for Jira Enterprise toggle.

  1. A message will confirm that the import is complete.

  2. Once the import is complete, it is recommended that you review/reconfigure the following:

    • Checklist permissions

    • Workflow validators

JavaScript errors detected

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

If this problem persists, please contact our support.