/
Migrate Checklists from Jira Server/ Data Center to Jira Cloud

Migrate Checklists from Jira Server/ Data Center to Jira Cloud

If you and your team are moving from Jira Server/ Data Center to Jira Cloud, be sure - your checklists will be safely migrated as well.

โ˜๐ŸผNOTE: For the features difference - check theServer & Data Center vs Cloud Comparison for Smart Checklist

Thereโ€™re two methods of Jira Server to Cloud migration:

โ˜๐ŸผNOTE: Make sure you are aware of recommendations from Atlassian on Server โ†’ Cloud migration and plan it properly

Contents ๐Ÿ‘‡๐Ÿผ

Jira Site Import

Check how to use Jira Site Import to migrate from server to cloud

Your checklists will be migrated automatically.

Jira Cloud Migration Assistant (JCMA)

Check how to use the Jira Cloud Migration Assistant to migrate from server to cloud.

For version 6.0.0 and higher

Preconditions

Server/Data center

  • update the Smart Checklist for Jira. Pro addon to the latest version;

  • update Jira Cloud Migration Assistant (JCMA) to the latest version.

Cloud

  • install the latest version of the Smart Checklist for Jira. Pro addon on your Cloud instance;

  • activate your Smart Checklist for Jira. Pro addon license/trial;

  • do not create custom fields `Checklists` and `Smart Checklist Progress` in advance.

JCMA flow

Navigate to Administration > System > Select โ€œMigrate to cloudโ€ in the left column.

Step 1: Assess your apps.

  1. Select Smart Checklist as an app that is `Needed in cloud`:

Step 2: Prepare your apps.

  1. Connect to your cloud instance.

  2. Check that you have Smart Checklist for Jira. Pro addon installed.

  3. Agree to migrate addon data.

Step 3: Assess and prepare your users.

  1. Connect to your cloud instance.

  2. Click โ€œBegin assessingโ€.

  3. Fix invalid emails if needed.

  4. Choose from the offered options what to do with users that have invalid emails.

  5. Click โ€œReview and applyโ€.

  6. Click โ€œApply to all migrationsโ€.

Step 4: Review all email domains.

  1. Review and mark email domains as trusted so that you migrate users with only email domains you trust.

  2. Click โ€œDoneโ€.

Step 5: Migrate your data.

  1. Click โ€œCreate a migrationโ€.

  2. Click โ€œConnect to cloudโ€.

  3. Enter the name of the migration.

  4. Select migration stage.

  5. Select Cloud instance.

  6. Click โ€œChoose migration optionsโ€.

  7. There are two available options: โ€œMigrate all dataโ€ and โ€œChoose what to migrateโ€.

  8. Select โ€œChoose what to migrateโ€.

  9. Select Projects, Users and Groups, Customers, and Apps to migrate.

  10. Run pre-migration checks and fix errors if needed.

  11. Review migration.

  12. Run migration.

Post actions

Wait until your migration finishes and check its status for Smart Checklist for Jira. Pro addon:

  • If the migration status of the Smart Checklist for Jira. Pro addon data is โ€œCompletedโ€ - the server part of the migration is successfully finished, you can wait for a few minutes and check your data on the Cloud instance:

  • In case during migration of the data some issues occur with data exporting from Server or connection to Cloud - migration status will be failed with error message available in the details:

You can check detailed logs for Smart Checklist migration by opening the page: /plugins/servlet/railsware/migrationlog

Synchronize Data on Cloud Instance

After migrating to the cloud, Smart Checklist data is stored in the database. However, some functions may not work correctly as they rely on data stored in issue properties and custom fields.

To resolve this, we recommend to Synchronize Checklist Storages after completing the JCMA migration.

ย 

FAQ about Smart Checklist add-on migration in versions 6.0.0 and higher

1. What data from Smart Checklist for Jira. Pro addon will be migrated from Server to Cloud?

We did our best to migrate all the data, but unfortunately, due to differences in Server and Cloud versions - there are some data types that will be available on Cloud in a different way or not available at all. Please see details information in the table below:

Data type

Migration support

Visibility on Server

Visibility on Cloud

Data type

Migration support

Visibility on Server

Visibility on Cloud

Checklist items

Checklist items with different markup:

  • raw text

  • simple items

  • items with details

  • bold, italic, emphasized text

  • numbered lists

  • unnumbered lists

  • images

  • links to external sources

  • links to Jira (same project or different, but also migrated project)

fully supported

ย 

ย 

Checklist items with dates

Supported, different UI

  • all dates are visible in same color

  • dates in the past, current and future visible in different colors

Checklist items with real assignees

Supported, different UI

  • id (username/login) is visible

  • user full name is visible

  • usernames of Smart Checklist item assignees are replaced with Cloud IDs during migration (visible on edit / โ€œChecklistsโ€ custom field)

Checklist items with not-existed assignees

Supported, different UI

ย 

ย 

Statuses

Default statuses

fully supported

ย 

Custom statuses

Supported, ORDER not KEPT

ย 

  • after migration it is needed to return needed order manually

Templates

Manual global / project templates (with trigger = none)

fully supported

ย 

global

project

global

ย 

ย 

project

Global / project template with trigger โ€œIssue createdโ€ without additional conditions

fully supported

  • template is applied to all issues types

ย 

  • template is applied to all issue types

Global / project template with trigger โ€œIssue createdโ€ with โ€œIssue Typeโ€ condition (is one of / equals)

fully supported

ย 

ย 

Global / project template with trigger โ€œIssue createdโ€ with โ€œIssue Typeโ€ condition (all issue types)

fully supported

ย 

ย 

Global / project template with trigger โ€œIssue createdโ€ with โ€œIssue Typeโ€ condition (is not one of / does not equal)

Partially supported

  • template applied based on conditions

  • template migrated without triggers (can be applied only manually)

Global / project template with trigger โ€œIssue createdโ€ with any conditions different from โ€œIssue Typeโ€

Partially supported

  • template applied based on conditions

  • template migrated without triggers (can be applied only manually)

Global / project template with triggers โ€œIssue updatedโ€, โ€œIssue transitionedโ€ with any extended conditions

Partially supported

  • template applied based on conditions

  • template migrated without triggers (can be applied only manually)

Global template with โ€œMultiple projectsโ€ selected

Supported, different logic

  • template is visible on โ€œGlobal templatesโ€ tab

Template will be saved as โ€œproject templateโ€ in migrated projects

Other

โ€œModify Smart Checklistโ€ post function

NOT supported

ย 

not migrated, as feature not available in Cloud

โ€œSmart Checklist Completedโ€ validator

NOT supported

ย 

not migrated, as Cloud has different implementation

Smart Checklist history

NOT supported

ย 

not migrated

ย 

2. I had custom fields โ€œChecklistsโ€ and โ€œSmart Checklist Progressโ€ created on Cloud before I run JCMA, I donโ€™t see migrated addon data in the Jira issues, what can I do?

In this case, after migration you will have duplicated custom fields:

Smart Checklist Addon on Cloud is using โ€œChecklistsโ€ and โ€œSmart Checklist Progressโ€ custom fields to sync data in, so after migration to have migrated data saved to the addon database (and visible in the addon) - you need to synchronize data from custom field to addon database.

Note: this process runs in the background and may take some time before all the data finishes synchronizing.

3. Will Smart Checklist global settings on the Server be migrated to Cloud?

Smart Checklist addon has the next settings based on versions:

Server / Data center

  • SC Addon visibility per Project

  • Display statuses for checklist items

  • Strikethrough checked items

  • Show on the customer portal

  • Notify assignees

Cloud

  • SC Addon visibility per Project

  • Display statuses for checklist items

  • Strikethrough checked items

  • Show on the customer portal

  • Notify assignees

Settings that are available only in Server - cannot be set up on the Cloud version.

Settings that are available in both versions are set up separately on different instances and are not migrated during JCMA migration.

4. How access rights to Smart Checklist are migrated from Server to Cloud?

In the Server version - access to Smart Checklist is managed by Jira permissions, so permissions are migrated together with users and groups via the JCMA tool to Cloud.

On the Cloud instance, you can proceed with using default Jira permissions or configure custom permissions for the Smart Checklist add-on.

ย 

For version 5.6.0 and lower

Pre-condition

"Checklists" custom field (mandatory) and "Smart Checklist Progress" custom field (optional) must be added to your Jira Server instance and must keep checklists' values.

Migration

  • Run your migration with Jira Cloud Migration Assistant tool

    • custom fields โ€œChecklistsโ€ and โ€œSmart Checklist Progressโ€œ will be created on the target instance (learn more about the Custom Fields Setup) with checklists content

  • Then go to Apps โ†’ Manage Apps โ†’ Smart Checklist โ†’ Global Settings โ†’ Synchronize checklist storages

  • Click โ€œSynchronizeโ€ button

  • The data from โ€œChecklistsโ€ custom field would be transferred to a database and checklists per Jira issues will be created.

  • NOTE: the process may take a while. Make sure to run it out of working ours of your organization/

Templates Migration

Templates wonโ€™t be migrated automatically at this moment. You have to re-create them manually on the target Cloud instance one by one.

Follow the steps below

  1. Go to Checklist Templates on Jira Server/ Data Center

    ย 

  2. Get the checklist template from the source Jira Server/ Data Center instance as a raw markdown text

    ย 

  3. Paste the checklist to any Jira issue in target Jira Cloud

  4. Save Template

  5. Proceed with the rest of the templates

  6. You may also use Full-Screen Editor for checklist adding/editing

Can I Migrate my Smart Checklist for Jira Server/ Data Center License to Jira Cloud?

Unfortunately, no. Smart Checklist for Jira Server/ Data Center license is a one-time purchase with optional maintenance, whereas Cloud purchases are recurring subscriptions. As such, existing Server/ Data Center app licenses cannot be transferred or credited to Cloud. These are independent licenses that need to be paid for separately.

Related content

Synchronize Data
Synchronize Data
Read with this
JQL Search
Read with this
"Checklists" Custom Field set up
"Checklists" Custom Field set up
Read with this
JQL Search Checklists
JQL Search Checklists
Read with this