The Integrity Checker allows you to check and fix invalid or duplicated values in the Xray data. It also enables you to clear Xray-calculated custom fields.

Integrity Checker

This section allows you to fix invalid Xray values that are stored in the database.

Test Runs

You can check and fix invalid or duplicated Test Runs.

Test Steps

You can check and fix invalid Test Steps and Mementos. A Memento is a copy of a Test Run so that when a Test is changed, the Test Run keeps the state prior to the Test changes.


You can check and fix Invalid Issue Links. These links can be of type Test Set <-> Test and Test <-> Precondition.


Calculated Custom Field Values

Starting from version 2.0.0 of Xray, the following Xray custom fields are recalculated upon any change and stored to be used when necessary. This means the value for a custom field is not calculated every time it is displayed. This improves performance considerably for several Xray screens and queries.

Because Jira does not provide the appropriate mechanisms and notifications for certain events like issue link events (https://jira.atlassian.com/browse/JRA-8505), Xray needs to intercept all requests that might change links and perform the appropriate calculations on its custom fields. Despite our best effort, there might be certain use cases where the custom fields are not updated, resulting in outdated values. When this happens, we provide the ability to remove the value of all custom fields. The value will then be calculated upon first access, or when a Jira re-index operation is performed.

Aside from being able to clear the custom field values, you can do bulk operations for:

  • Resetting the value of the Requirement Status custom field on Requirement issues
  • Resetting the value of the TestRunStatus custom field on Test issues

Additionally, Xray provides some specific issue operations that allow you to clear the custom field values individually:

  •  Resetting the Requirement Status custom field for a Requirement issue
  •  Resetting the TestRunStatus custom field for a Test issue
  •  Resetting the Test Execution Defects Count custom field for a Test Execution and Sub-Test Execution issue.

The Xray calculated custom fields that you can clear are:

  • Requirement Status Cache

Cache that contains all the Requirement Status that were previously calculated

  • Test Run Status Custom Field 

Calculated Custom Field that has the Test Run Status for a Test

  • Manual Steps Count Custom Field

Calculated Custom Field that has the number of Manual Steps of a Test

  • Test Set Test Count and Test Plan Test Count

Calculated Custom Field that has the number of Test Sets and Test Plans of a Test

  • Test Execution Defects Custom Field

Calculated Custom Field that has the number of defects created in the context of a Test Execution


  • No labels