Admin feature only.

Introduction

As an Xray administrator, you can configure thresholds for archiving Test Executions.

Test Execution Archiving enables the cleanup of unused Test Runs and Test Executions, reducing the number of historical Test Runs that may add complexity without providing value or defining the status of any Requirements.

Check Test Run Archiving and Archiving Xray Issues for additional information.

How it Works

Archiving Test Executions allows you to hide them in Xray/Jira while preserving their data, so you can access it if needed later. This helps reduce clutter in Xray and Jira views, especially when importing automated Test results into Xray.

Test Runs can accumulate quickly, but usually, only the latest results are relevant. Older Test Execution Issues can be archived automatically by Xray, using Jira's Issue archiving mechanism.

Archived Test Executions Data

Archiving Test Executions does not delete Test Run data. Archived Test Execution Issues are hidden from Issue views, Xray reports and gadgets, and will not appear in Issue searches. To locate them, you will need to save their Issue key.

You can access archived Test Executions like any other archived Issues in Jira; however, Test Run data will only be visible once the Test Execution Issue is unarchived.

Test Executions Eligible for Archiving

All Test Executions within the selected projects (Figure 2 - 3) are eligible for archiving, except those with Test Runs that directly impact Requirement status. For example, if Requirement A is marked as "FAIL/NOT OK" due to Test Run A, this Test Run will not be archived, as it reflects the current status of Requirement A in Xray reports. The same holds true for Test Runs that affect the latest results in a specific version, Test Plan, or environment. Therefore, a Test Execution will only be archived if none of its Test Runs affect Requirement status and all Issues it contains are eligible for archiving.

Access

On your Jira Data Center instance, click the gear icon (Figure 1 - 1) and then select Manage Apps (Figure 1 - 2).

Figure 1 - Access

An Xray menu will open on the left side of the screen. There, click the Test Execution Archiving option (Figure 2 - 1) and the Test Execution Archiving screen opens (Figure 2).

Figure 2 - Menu

Configuration

Feature Enablement

Use the toggle (Figure 2 - 2) to enable/disable the Test Execution Archiving.

Adding Projects

You can add Projects by clicking the Add Projects button (Figure 2 - 3) and selecting the projects containing the Test Execution Issues you wish to archive. Then, they will appear right there (Figure 2 - 3).

Configuring the Threshold for Archiving Test Executions

The threshold can be set to a value between one day and two years. Use the slider (Figure 2 - 4) or select one of the predefined time frames (Figure 2 - 5) to choose the desired value, with a maximum limit of two years.

You can also specify how frequently you want Test Execution Issues to be archived (Figure 2 - 6).

Once you're finished, click Save (Figure 2 - 7).

If you have questions or technical issues, please contact the Support team via the Customer Portal (Jira service management) or send us a message using the in-app chat.