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

# Overview

In the Xray Space Settings, you can manage Test statuses at the Space level. All Test statuses created at the Admin level (Figure 2) will be displayed on the Space’s Test statuses screen (Figure 5), with the option to enable or disable each status for that specific Space.

# How it Works

## Xray Settings

> 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://2fc78642-8d61-4ed5-a346-6ae7dabe0ac6)
> 
> > Macro (rw-step)
> 
> The Test Statuses screen will open (Figure 2)
> 
> ![Figure 2 - Test statuses](media://82f5ca18-c3d1-47d8-afb0-865d69fb53f0)
> 
> Here, you can:
> 
> - Manage custom [Test Run](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565109) statuses for Xray (Figure 2 - 1) and view the corresponding Spaces (Figure 2 - 2).
> - Add new Test statuses (Figure 2 - 3):
>   - Insert a name.
>   - Pick a color.
>   - Select a Test coverage status.
>   - Add a description (optional).
>   - Choose if the Test status is final or not by using the box (Figure 2 - 4).
>   - Select to enable the Test status for all Spaces (Figure 2 - 5) or select a Space (Figure 2 - 6).
> - Once you're finished, click *Add* (Figure 2 - 7) and the new Test status will appear on the Test statuses table (Figure 2 - 2).
> 
> > Macro (rw-step)
> 
> You can edit/delete the newly added Test statuses (Figure 2 - 1) at any time by clicking the *Edit*/*Delete* button (Figure 2 - 8).
> 
> > ℹ️ Go [here](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44566467) to see the full operations regarding Test Statuses.

## Space Settings

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> On your Jira Cloud instance, enter a Space (Figure 3 - 1), click the corresponding ellipsis icon (Figure 3 - 2), and then click *Space Settings* (Figure 3 - 2).
> 
> ![Figure 3 - Projects](media://d7b85f51-f6d2-4034-9b42-ab732aa50db9)
> 
> > Macro (rw-step)
> 
> A new menu will appear on the left side of the screen. There, click *Xray Settings* (Figure 4 - 1).
> 
> ![Figure 4 - Settings](media://76023af7-ba82-4353-b558-3a4e447deb5f)
> 
> > Macro (rw-step)
> 
> Another menu will open (Figure 5). There, click *Test Statuses* (Figure 5 - 1).
> 
> ![Figure 5 - Settings](media://d9ba9476-6184-4d4d-9feb-b46c4faa0512)
> 
> Here, you can manage Test statuses at the Space level. All Test statuses created at the admin level will be displayed on the Space's Test Step statuses screen (Figure 5 - 2), with the option to enable or disable each status for that specific Space (Figure 5 - 4). 
> 
> In this specific example, you can see the statuses added from Figure 2 (Figure 5 - 3).
> 
> > ℹ️ Creating new Test (Run) statuses may be done in the [Global Settings: Test Statuses](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44566467) configuration section of Xray, but they can be enabled or disabled at the Space level (Figure 5 - 4).

> ✅ If you have a status that doesn't apply to the workflow of a Space, you should consider disabling it to help clean up your workflows. Technically, all statuses are Global statuses.

> ℹ️ **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 6 - 1) to take its place. Click *Save* to proceed (Figure 6 - 2), and the changes will take effect immediately.
> ℹ️ 
> ℹ️ ![Figure 6 - Migration](media://c562e9d5-f3ba-41db-989d-b25763eb5bc4)

# FAQs

## Feature Behaviour and UI

**1 - Is there a required permission level to view or modify these settings?**

There are no additional permissions required. If you could edit the statuses at the Global level before, you would get access to the features there. Likewise, with the Space-level settings, if you had access to them previously, you will be able to toggle on/off the statuses.

**2 - What happens if a user disables a Test Status at the Space level?**

**2.1 - Will it disappear from existing Test Executions?**

It follows the same pattern as deleting a status at the Global level. If the status is in use, the admin will see the screen to migrate the use of the status to an enabled one.

**2.2 - Can it still be seen in historical data?**

No, as it will have been migrated to a different status.

**3 - Can statuses be re-enabled later without data loss?**

Yes, statuses can be re-enabled with no consequence. They will effectively be a new status.

**4 - Will the status options be filtered automatically in dropdowns based on Space configuration?**

Yes. Wherever statuses are displayed, they will be based on the scope of the Space.

## Configuration and Scope

**5 - Can different Spaces have entirely different enabled statuses, or is there a fallback/default behavior?**

All Spaces will have the default PASSED, TODO, EXECUTING, and FAILED statuses, as it is currently. They cannot be deleted, nor will they be able to be disabled. But other than that, they can have unique lists.

**6 - Are these Space-specific settings inherited from the Global ones, or do they override them? **

They are in the same setting (so they are inherited, not overridden), but it can be done at the admin level to avoid needing to go Space by Space.

**7 - Is there an audit log or trace of when a status is enabled/disabled at the Space level?**

No.

**8 - Are there known limitations/impacts on other features or compatibility Issues users should be aware of?**

No.

## Integration and API

**9 - What’s the intended use of the Space ID in the API changes? **

So users can check which statuses are available for a given Space.

**10 - Should external users expect these changes to impact how test statuses are returned in ****[GraphQL](https://docs.getxray.app/display/XRAYCLOUDDRAFT/GraphQL+API)**** queries or REST APIs?**

No.

**11 - Are these changes backward compatible?**

Yes, since it is an optional parameter.