Zephyr Squad to Scale Upgrade Guides

Applies to Zephyr Scale Cloud, last modified on April 05, 2023.


Over the last few months, we received many requests from clients to upgrade from Zephyr Squad to Zephyr Scale. As of today, this is not a native capability we provide, and upgrading to Zephyr Scale requires implementing scripts that rely on the Zephyr Squad and Scale APIs. To address this issue, we are currently working on a native built-in solution that enables to automatically upgrade from Zephyr Squad to Zephyr Scale.

You will find all the necessary information below and the related sub-sections to make sure that you have all the information needed to:

  • understand when the solution will be available
  • identify the additional features from Zephyr Scale
  • identify the Zephyr Squad features that will not be part of Zephyr Scale
  • identify the data lost and transformed during the upgrade
  • understand the impact on pricing and existing license
  • estimate time and effort required to upgrade

High-level Roadmap

Our team is currently working on a solution to upgrade from Squad to Scale. The first solution will only be available for an upgrade on our cloud versions.

If you are looking for a Squad Server to Scale Server upgrade, please reach out to our support team.

If you are evaluating the opportunity to make a Squad to Scale upgrade, please refer to the following pages to identify the current feature gaps and the data that is not migrated. This will ensure you have all the necessary information.

Here is our current roadmap to deliver the solution to upgrade:

  1. In December 2022, we open registration for our beta program. The program will be open for registrations until it is full or sometime in Q1 2023.

    Click here to register for the beta program.

  2. The first upgrades will start in Q1 2023. Our support team and our engineering team will support the first upgrades. Our team will first contact selected customers to validate if they are ready to start upgrading to Scale. In the first version of the solution, we will support upgrades by transferring only test cases. This means that all the data related to executions and cycles will be lost. There will be no mechanism to transfer additional data with the upgrade engine after an initial upgrade covering only test cases.
  3. In Q4 2023, we will start a second stage by supporting upgrades and transferring as much data as possible, including test cases, test cycles, test executions, and their related attachments and comments.
  4. In Q1 2024, the upgrade engine will be generally available, so all our customers can trigger upgrades.
Note: Any and all information by or on this site is provided for informational purposes only and is not to be relied upon so for purchasing or planning purposes. The roadmap is subject to change or delay. The development, release, and timing remain dependent on these changes or delays.


Zephyr Squad and Zephyr Scale licenses are not interchangeable. Thus, you must buy a new Zephyr Scale license for your Jira instance when you upgrade. If there are more than six months left to run on the Zephyr Squad for Jira Cloud subscription, a pro-rata discount is available on request. The discount is in the form of a promo code which you can use to apply a discount on the new Zephyr Scale subscription. You can let the Zephyr Squad license expire.

During the upgrade/UAT phase, we can arrange for dual licensing upon request. We provide a limited free license if you have a paid or commercial license in place. If you have any questions about licenses, feel free to email [email protected]

Time and Efforts Required to Upgrade

To shorten the upgrade process, you can upload attachments to Scale Cloud Storage before the upgrade. It can take a few days or weeks depending on their size. You can migrate any attachments during the upgrade process even if you didn’t upload them to Scale Cloud Storage earlier.

We don’t recommend using Squad projects during the upgrade to avoid data inconsistencies. If the upgrade fails, you can run it again. However, it will overwrite the transferred data. We do not support delta transfer of objects created after the upgrade.

In the beta stage, you should use the REST APIs to manage the upgrade process

Note: The REST API endpoints are different for Zephyr Scale. If you are doing automation, you need to update your automation scripts with the new endpoints.

You cannot cancel or stop a running upgrade until it is in a completed state. A completed state would mean that upgrade finished or failed.

Register for Beta Program

The registration for our beta program is open. The program will be open for registrations until it is full or sometime in Q1 2023.

Click here to register for the beta program.

Should you have any questions, please reach out to our Support team.

Highlight search results