Migrate to Zephyr Squad New Experience
The Migration Process
How to migrate?
The interface enables users to review the list of entities available for migration and identify those that will not be migrated before initiating the migration process.
Start the migration
Navigate to Apps in your Jira workspace and select Migrate to new Squad.
Mark the checkbox and click Start the Migration.
If there is another migration in progress, you will not be able to begin. Wait for the other migration to complete. The next migration process will start automatically.
Warning
Once the migration starts, you can't cancel the process.
How to track progress?
Once the migration begins, you can track its progress in the user interface through a progress bar, which displays the overall progress for all projects. If the migration encounters issues or fails, the progress stops and the error message appears.

Migration complete

Migration partially complete

You can see error logs and review the details of the encountered errors.

Migration fails

In the event of failure or a partial success situation requiring another migration attempt, users must initiate the migration process once more from the beginning. Click the Re-run migration button to navigate back to the initial page. The system will verify if any other migration is in progress.
Warning
When the migration is run again, the migrated data will be overwritten and the migration will start from beginning.
Which data can't be migrated?
The migration engine does not support migrating BDD data. Once the migration process begins, the delta data cannot be migrated at a later time. We therefore advise that you only initiate the migration process if the migration of BDD data is not crucial for your requirements. Furthermore, Zephyr Squad new experience does not have the execution history feature, so it will not be migrated.
Using the product during the migration
You can use the product during a test migration, unless you need to verify the newly generated data in Zephyr Squad. Any data generated during the test migration may be overlooked and will not be transferred to the new experience. However, during a production migration, you should refrain from using the product to prevent potential data inconsistencies. Any data generated during the production migration will not be transferred. There is no provision to migrate them later, as we do not support the migration of delta data.
Migration completion
Once the migration is finished, you can assess your data in the Zephyr Squad app. Click on Open new experience.

You can also switch back to the old experience before finalising the migration.
You're all set!

Data that will not be migrated
BDD data
Test execution history
Test execution saved filters
JQL saved filters
Test steps custom fields change history
Custom field of type Select list (cascading)
Custom field of type Label
Advanced custom fields for test cases