Overview
As a Jira administrator, you can create additional Test Step statuses. These statuses are applied to Test Step results. Each status can have a name, description, a specific color, and a Test Run 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
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).
Figure 1 - Apps
The Test Step Statuses screen will open (Figure 2).
Figure 2 - Test step statuses
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.
Enabling/Disabling a Test Step Status
Click View projects (Figure 2 - 2). A new screen will open (Figure 3).
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.
Figure 3 - Toggle
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
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.
Figure 5 - Use
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.
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).
Figure 6 - Apps
The Test Step Statuses screen will open (Figure 7). Click Edit (Figure 7 - 3) on the respective custom status to modify it.
Figure 7 - Test step statuses
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.
Figure 8 - Edit
Once you're done, click Save (Figure 8 - 5) to confirm the changes or Cancel (Figure 8 - 5) to go back to editing. The confirmed changes will become effective immediately.
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.
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).
The Test Step Statuses screen will open (Figure 7). Click Delete (Figure 7 - 3) on the respective custom status to remove it.
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.
Figure 9 - Modal