August 25th, 2023

The Xray team is proud to announce the release of Xray 7.2.0.

This version updates Test case versioning for Xray Enterprise, enabling the feature on project imports, DocGen and migration to Cloud.


Upgrade Notes

Upgrading Xray to 7


If you are upgrading from a version lower than 3.2, this implies that an upgrade task will run to pre-calculate historical data. This one-time action will run in the background so that Xray remains available during the upgrade. A  re-index operation of your Jira instance is required to make the internal data searchable and usable by Xray.

Please be aware that this upgrade task will run immediately after updating Xray. As this operation can take some time and use a considerable amount of server resources, we suggest scheduling the upgrade of Xray outside of business hours. It is always possible to cancel the recalculation operation in the Xray configuration section → Custom Fields → Maintenance.

If upgrading from v3.2.x or v3.3.x to v7, you must recalculate data in the Xray configuration section → Custom Fields. This recalculation is necessary because of the huge improvement in the amount of data that Xray needs to add to the table and the Lucene indexes.

As this operation can take some time and use a considerable amount of server resources, we suggest scheduling the upgrade of Xray and recalculating the custom fields outside of business hours.

Downgrading from Xray 7


Downgrading from Xray 7.x.x to a previous version may have the following side effects:

After creating some specific data using Test Case Versions, the user may have some glitches when downgrading to a specific version of Xray

  • On a Test Issue, multiple manual test versions with steps, when downgrading the test issue will show all steps from all the versions
  • On a Test Issue, multiple manual test versions with specific datasets, when downgrading the test issue will show the parameters from all the datasets 
  • On a Test issue, having different test versions linked to the same precondition issue when downgrading, the test issue will show an integrity error instead of showing the precondition table


    And the precondition will show the warning of being linked to an archived test

Release highlights 

Test Case Versioning extended support




This highly requested Xray Enterprise feature allows users to create and manage multiple versions of the same test case, to
easily track and revert changes in your test specification.

With this new release, we are bringing all the advantages of Test Case Versioning to more areas of the application, such as:
  • Project Import,
  • DocGen,
  • DC to Cloud Migration

Test case versioning is a powerful feature that can help you manage your test specification more efficiently and effectively. It is available for Xray Enterprise customers only.


If you want to learn more about Test case versioning, please visit our documentation page here.





Just one more, yet important, thing...

Documentation is always important, and sometimes you may miss it.

This time we added some articles showing how to take advantage of Jira built-in automation capabilities. Examples include the integration with the popular MS Teams and Slack communication tools to share test results; but there's more!

We also include tutorials to show how to migrate from other test management tools, to foster adoption of Xray in your teams.


Here's a summary of all the relevant articles that we've added and updated recently:



All New Features and Bug Fixes in this release