---
title: "Global Settings: Test Step Statuses"
canonical: "https://docs.getxray.app/space/XRAYCLOUD/44566490/Global%20Settings%3A%20Test%20Step%20Statuses"
format: markdown
---
> Macro (rw-ui-expands-macro)
>
> > Macro (rw-expand)
>
> > Macro (toc)
# Overview
As a Jira administrator, you can create additional Test Step statuses. These statuses are applied to [Test Step](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565316) results. Each status can have a name, description, a specific color, and a [Test Run](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565109) status.
If you delete a status and there are Test Step results in this particular status, then you'll be prompted for a migration status field to update the affected Test Steps.
# Operations
## Creating a Custom Test Step 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 Step Statuses* (Figure 1 - 3).
>
> 
>
> > Macro (rw-step)
>
> The Test Step Statuses screen will open (Figure 2).
>
> 
>
> To create a new Test Step status, go to *Add New Test Step Status* (Figure 2 - 4) and:
>
> - Insert a name.
> - Pick a color.
> - Add a description.
> - Select a Test coverage status.
> - Use the toggle to enable the Test Step status for all projects (Figure 2 - 5) or select a Project (Figure 2 - 6).
>
> > ℹ️ 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.
## Editing a Custom Test Step Status
> ℹ️ - Native Test Step 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 1 - 1). Then, select *Apps* (Figure 1 - 2).
>
> A menu will open on the left side. There, click *Test Step Statuses* (Figure 1 - 3).
>
> > Macro (rw-step)
>
> The Test Step Statuses screen will open (Figure 2). Click *Edit* (Figure 2 - 3) on the respective custom status to modify it.
>
> > Macro (rw-step)
>
> All the fields will be able to be edited (Figure 4):
>
> - Name (Figure 4 - 1): insert a new name.
> - Description (Figure 4 - 2): type a new description.
> - Color (Figure 4 - 3): click the colored square to select a different color.
> - Test Run status (Figure 4 - 4): use the dropdown to choose a Test Run status.
>
> 
>
> Figure 4 - Edit
>
> > ℹ️ 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 Step 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 Step status enabled. Use the corresponding toggle (Figure 3 - 2) to enable or disable the Test Step status at any time for each individual project.
>
> 
>
> > 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.
>
> 
>
> > ℹ️ **Migration of In-use Statuses**
> > ℹ️
> > ℹ️ When a Test Step 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.
> > ℹ️
> > ℹ️ 
## Editing a Custom Test Step Status
> ℹ️ - Native Test Step 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 Step Statuses* (Figure 6 - 3).
>
> 
>
> > Macro (rw-step)
>
> The Test Step Statuses screen will open (Figure 7). Click *Edit* (Figure 7 - 3) on the respective custom status to modify it.
>
> 
>
> > Macro (rw-step)
>
> All the fields will be able to be edited (Figure 8):
>
> - Name (Figure 8 - 1): insert a new name.
> - Description (Figure 8 - 2): type a new description.
> - Color (Figure 8 - 3): click the colored square to select a different color.
> - Test Run status (Figure 8 - 4): use the dropdown to choose a Test Run status.
Deleting a Custom Test Step 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 Step Statuses* (Figure 6 - 3).
>
> > Macro (rw-step)
>
> The Test Step 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 Step status, and it will be deleted immediately.
>
> 
> ℹ️ [Enabling Test Step statuses at the Project Level](https://getxraydocs.atlassian.net/wiki/pages/createpage.action?spaceKey=xraycloud&title=Project%20Settings%3A%20Test%20Step%20Statuses&linkCreation=true&fromPageId=44566490)