Overview
In the Xray Project Settings, you can manage Test Step statuses at the Project level. All Test Step statuses created at the Admin level will be displayed on the Project's Test Step statuses screen, with the option to enable or disable each status for that specific project.
How it Works
Xray Settings
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
Here, you can:
- Manage custom Test Step statuses for Xray (Figure 2 - 1) and view the corresponding projects (Figure 2 - 2).
- Add new Test statuses (Figure 2 - 4):
- Insert a name.
- Pick a color.
- Select a Test coverage status.
- Add a description (optional).
- Select to enable the Test Step status for all projects (Figure 2 - 5) or select a Project (Figure 2 - 6).
- Once you're finished, click Add (Figure 2 - 7), and the new Test Step status will appear on the Test Steps statuses table (Figure 2 - 1).
You can edit/delete the newly added Test Step statuses (Figure 2 - 1) at any time by clicking the Edit/Delete button (Figure 2 - 3).
Go here to see the full operations regarding Test Step statuses.
Project Settings
On your Jira Cloud instance, enter a Project (Figure 3 - 1), click the corresponding ellipsis icon (Figure 3 - 2), and then click Project Settings (Figure 3 - 2).
Figure 3 - Projects
A new menu will appear on the left side of the screen. There, click Xray Settings (Figure 4 - 1).
Figure 4 - Settings
Another menu will open (Figure 5). There, click Test Step Statuses (Figure 5 - 1).
Figure 5 - Settings
Here, you can manage Test Step statuses at the Project level. All Test Step statuses created at the admin level will be displayed on the Project's Test Step statuses screen (Figure 5 - 2), with the option to enable or disable each status for that specific Project (Figure 5 - 4).
In this specific example, you can see the statuses added from Figure 2.
Creating new Test Step statuses may be done in the Global Settings: Test Statuses configuration section of Xray, but they can be enabled or disabled at the Project level (Figure 5 - 4).
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 6 - 1) to take its place. Click Save to proceed (Figure 6 - 2), and the changes will take effect immediately.
Figure 6 - Migration
If you have a status that doesn't apply to the workflow of a project, you should consider disabling it to help clean up your workflows. Technically, all statuses are Global statuses.
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 Project 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 Step Status at the Project 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 Project configuration?
Yes. Wherever statuses are displayed, they will be based on the scope of the Project.
Configuration and Scope
5 - Can different Projects have entirely different enabled statuses, or is there a fallback/default behavior?
All projects 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 Project-specific settings inherited from the Global ones, or do they override them?
They are the same setting (so inherited, not overridden), but it can be done at the admin level to avoid needing to go Project by Project.
7 - Is there an audit log or trace of when a status is enabled/disabled at the Project 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 project ID in the API changes?
So users can check which statuses are available for a given Project.
10 - Should external users expect these changes to impact how test statuses are returned in GraphQL queries or REST APIs?
No.
11 - Are these changes backward compatible?
Yes, since it is an optional parameter.