Workflow States
Workflow states are the individual labels that describe where a test case, run, or session currently stands. Each context — Repository, Runs, and Sessions — has its own independent set of states that you create and manage from Admin → Workflows.
State properties
| Property | Description |
|---|---|
| Name | Display label for the state. Maximum 100 characters. Must be unique within the context. |
| Icon | A visual icon that represents the state. Shown alongside the state name throughout the product. |
| Color | A hex colour code applied to the icon. Helps distinguish states at a glance. |
| Display Order | Controls sort order in lists. Lower numbers appear first. States with the same order are sorted by ID. |
| Enabled | When enabled, the state is available for use. When disabled, it is hidden from selection in new assignments but still exists in historical data. |
| Default | Exactly one state per context is the default. It is pre-selected automatically when no other state has been explicitly assigned. See Default state below. |
Creating a state
- Go to Admin → Workflows and select the context tab (Repository, Runs, or Sessions).
- Click New State.
- On the STATE tab, enter a Name, choose an Icon and Color, and optionally set a Display Order.
- Toggle Enabled on or off depending on whether you want the state to be immediately active.
- Toggle Default if this state should be the default for the context (see Default state).
- Switch to the PROJECTS tab to configure which projects this state is available in (see Project Assignment).
- Click Save.
Editing a state
Click the edit action on any state row to open the edit modal pre-filled with the current values. You can change any property — name, icon, colour, display order, enabled state, default state, and project assignment. Click Save to apply the changes.
Enabling and disabling a state
Use the toggle in the Enabled column to activate or deactivate a state immediately, without opening the edit modal. Disabled states are hidden from selection on new items but remain visible on any historical records that previously used them.
The default state cannot be disabled. If you need to disable the current default, first set a different state as the default, then disable the original.
Default state
Every context has exactly one default state. The default is automatically applied to new items in that context when no state has been explicitly chosen.
To change the default, use the toggle in the Default column or the checkbox in the edit modal. The previous default is automatically cleared — a context can only have one default at a time.
Setting a disabled state as default will automatically enable it. If the state you select is currently disabled, a confirmation prompt will explain that it will be enabled as part of the change.
Deleting a state
Click the delete action on a state row and confirm. The state is permanently removed from the context.
Some states cannot be deleted. You cannot delete the default state or the only remaining enabled state in a context. To delete a default state, first assign a different default. To delete the last enabled state, create a replacement first.
Searching and filtering
Use the search input above the states list to filter by state name or icon name. The list updates in real time as you type. Clear the input to show all states.
State ordering
States are displayed in ascending order by Display Order. When two states have the same display order value, they are further sorted by their ID (oldest first). To reorder states, edit the Display Order field in the create or edit modal — lower numbers surface first in picker menus and lists throughout the product.