---
title: "Global Settings: Test Statuses"
canonical: "https://docs.getxray.app/space/XRAYCLOUD/44566467/Global%20Settings%3A%20Test%20Statuses"
format: markdown
---
> Macro (rw-ui-expands-macro)
> 
> > Macro (rw-expand)
> 
> > Macro (toc)

# Overview

As an Xray administrator, you can create custom [Test Run](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565109) statuses. These statuses can only be applied to Test Run overall results. Test step results can't be changed to custom statuses. Each status can have a name, description, marked final and have a specific color (Figure 2).

# Operations

## Creating a Custom Test Status

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> On your Jira Cloud instance, click the administration/gear icon (Figure 1 - 1). Then, select *Apps* (Figure 1 - 2).
> 
> A menu will open on the left side. There, click *Test Statuses* (Figure 1 - 3).
> 
> ![Figure 1 - Apps](media://817bf96f-430b-4c82-ab3f-ecc74123d77e)
> 
> > Macro (rw-step)
> 
> The Test Statuses screen will open (Figure 2).
> 
> ![Figure 2 - Test statuses](media://bdb0d8eb-ad45-4fc6-9b52-aa487d89d59f)
> 
> To create a new Test status, go to *Add New Test Status* (Figure 2 - 4) and:
> 
> - Insert a name (mandatory field).
> - Pick a color (mandatory field).
> - Select a Test coverage status (mandatory field).
> - Add a description (optional).
>   - Choose if the Test status is final or not by using the box (Figure 2 - 5).
>   - Select to enable the Test status for all projects (Figure 2 - 6) or select a project (Figure 2 - 7).
> - Once you're finished, click *Add* (Figure 2 - 8), and the new Test status will appear on the Test statuses table (Figure 2 - 1).
> 
> > ℹ️ You can edit/delete the newly added Test statuses at any time by clicking the *Edit*/*Delete* button (Figure 2 - 3). All existing custom statuses can be modified. More below.

## Enabling/Disabling a Test Status

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> Click *View projects* (Figure 2 - 2). A new screen will open (Figure 3).
> 
> > Macro (rw-step)
> 
> Here you can see which project(s) (Figure 3 - 1) have this Test status enabled. Use the corresponding toggle (Figure 3 - 2) to enable or disable the Test status at any time for each individual project.
> 
> ![Figure 3 - Toggle](media://259c856e-982a-455f-a363-f449cc6f7160)
> 
> > Macro (rw-step)
> 
> When disabling a Status, a modal will open (Figure 4) for you to confirm the operation. Click *Save* to proceed (Figure 4 - 1), and the changes will take effect immediately.
> 
> ![Figure 4 - Modal](media://c3a2445c-e3e7-4cc5-bcf6-c7d1d850141f)
> 
> > ℹ️ **Migration of In-use Statuses**
> > ℹ️ 
> > ℹ️ When a Test status is in use and you are trying to toggle it off, you will need to select another status (Figure 5 - 1) to take its place. Click *Save* to proceed (Figure 5 - 2), and the changes will take effect immediately.
> > ℹ️ 
> > ℹ️ ![Figure 5 - Use](media://2768743a-24b0-454f-ba81-340fa330744b)


## Editing a Custom Test Status

> ℹ️ - Native Test Run statuses can't be modified or deleted.
> ℹ️ - You can edit the projects for which a given status is available.

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> On your Jira Cloud instance, click the administration/gear icon (Figure 6 - 1). Then, select *Apps* (Figure 6 - 2).
> 
> A menu will open on the left side. There, click *Test Statuses* (Figure 6 - 3).
> 
> ![Figure 6 - Test statuses](media://02fec104-b130-451b-a79e-48246232bda3)
> 
> > Macro (rw-step)
> 
> The Test Statuses screen will open (Figure 7). Click *Edit* (Figure 7 - 3) on the respective custom status to modify it.
> 
> ![Figure 7 - Test statuses](media://e1c7eac4-ae1e-4c0b-b900-d89e32b65d29)
> 
> > Macro (rw-step)
> 
> All the fields can be edited (Figure 8):
> 
> - Name (Figure 8 - 1): insert a new name.
> - Description (Figure 8 - 2): type a new description.
> - Final (Figure 8 - 3): use the box to define wether <span style="color: #172B4D">the custom status is final or not. </span>
> - <span style="color: #172B4D">Color (Figure 8 - 3): click the colored square to select a different color.</span>
> - <span style="color: #172B4D">Test coverage status (Figure 8 - 4): use the dropdown to choose a Test Run status.</span>
> 
> ![Figure 8 - Edit](media://c0577e3e-0c05-48bf-a8cb-3401fd8daa68)
> 
> > Macro (rw-step)
> 
> <span style="color: #172B4D">Once you're done, click </span>*<span style="color: #172B4D">Save</span>*<span style="color: #172B4D"> (Figure 8 - 5) to confirm the changes or </span>*<span style="color: #172B4D">Cancel</span>*<span style="color: #172B4D"> (Figure 8 - 5) to go back to editing. The confirmed changes will become effective immediately.</span>

## Deleting a Custom Test Status

> ℹ️ If you delete a status and there are Test Runs in this particular status, then you'll be prompted for a migration status field to update the affected Test Runs.

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> On your Jira Cloud instance, click the administration/gear icon (Figure 6 - 1). Then, select *Apps* (Figure 6 - 2).
> 
> A menu will open on the left side. There, click *Test Statuses* (Figure 6 - 3).
> 
> > Macro (rw-step)
> 
> The Test Statuses screen will open (Figure 7). Click *Delete* (Figure 7 - 3) on the respective custom status to remove it.
> 
> > Macro (rw-step)
> 
> A modal will open (Figure 9).
> 
> Click *Delete* (Figure 9 - 1) to confirm the removal of the custom Test status, and it will be deleted immediately.
> 
> ![Figure 9 - Modal](media://c3a2445c-e3e7-4cc5-bcf6-c7d1d850141f)

> ℹ️ [Enabling Test statuses at the Project Level](https://getxraydocs.atlassian.net/wiki/pages/createpage.action?spaceKey=xraycloud&title=Project%20Settings%3A%20Test%20Statuses&linkCreation=true&fromPageId=44566467)