---
title: "Workflows"
description: "Define the workflow states test cases, test runs, and explorations move through in TestOrchestrator — three independent workflows, each with its own default state and automation."
source: "https://testorchestrator.com/docs/workflows"
---

# Workflows

A workflow is the set of states a test case, a test run, or an exploration moves through — Draft to In review to Approved, Not started to In progress to Complete. Each of the three has its own independent workflow, its own default state, and its own automation. They are configured in **Settings → Workflows**.

> **This module used to be called Lifecycles.** The name changed; nothing else about it moved. The old address, `/docs/lifecycles`, still resolves here, and the settings page itself is still at `/admin/lifecycles` — bookmarks and saved links keep working.

## What a workflow state is

A workflow state is a label that says where an item currently stands. States answer questions like:

- Which test cases have been reviewed and approved?
- Is this run still being executed, or is it done?
- Which explorations have been wrapped up?

You define the states that suit your team — the name, an icon and a colour, the order they appear in, and which projects offer them. Nothing is hardcoded.

## Three workflows, on three tabs

The page opens on three tabs, and each one is a separate workflow. A state belongs to exactly one of them; nothing is shared across the three. The tab you are on is part of the address, so a link to a particular workflow lands on it.

- **Test case workflow**: The **State** property on a test case, its column in the case list, and the _State_ grouping and filter. Example states: _Draft_, _In review_, _Approved_.
- **Test run workflow**: The **State** row on a run’s About card, the **State** pill in the run composer, **Set state…** in the run list’s bulk actions, the run list’s _State_ facet, and the state chip in the run header. Example states: _Not started_, _In progress_, _Complete_. Two automation rules can move a run between them on their own.
- **Exploration workflow**: The state a new exploration starts in, and the state it moves to when it is closed. Note that no exploration screen shows or lets you change this state today — it is applied on the server and is not the same thing as the built-in **Planned → Live → Debriefed** session state you see on the exploration itself.

## What the page looks like

Under the tabs sits one panel listing that workflow’s states, with a search box, a refresh button and **New state**. Each row carries:

- **State** — the icon in its colour, the name (a link to the state’s own page), and a **Default** chip on whichever state is the default.
- **Order** — the display order number the list is sorted by.
- **Projects** — _All_, a count, or a **None** warning.
- **Status** — _Enabled_ or _Disabled_.
- A **···** menu holding every action for that row.

Below the list is an **automation panel** for the same workflow — on the same page, not behind a button. See [Workflow Automation](https://testorchestrator.com/docs/workflows/automation).

## Getting started

1. Go to **Settings → Workflows**.
2. Pick the tab you want to configure: **Test case workflow**, **Test run workflow**, or **Exploration workflow**.
3. Click **New state** and fill in the editor that opens. See [Workflow States](https://testorchestrator.com/docs/workflows/workflow-states).
4. Decide which projects offer it — see [Project Assignment](https://testorchestrator.com/docs/workflows/project-assignment).
5. Set the automation for that workflow in the panel under the list.

## Who can manage workflows

Workflows is a workspace-level setting: it is configured once and applies everywhere, and it is not gated by your plan.

| Action | Who can do it |
| --- | --- |
| Open Settings → Workflows | Tenant Admin, Project Admin |
| Create, edit, or delete workflow states | Tenant Admin, Project Admin |
| Enable, disable, or promote a state to default | Tenant Admin, Project Admin |
| Assign states to projects | Tenant Admin, Project Admin |
| Configure automation | Tenant Admin, Project Admin |

- [Workflow States](https://testorchestrator.com/docs/workflows/workflow-states) — Create, edit, order, enable, promote and delete the states in a workflow.
- [Project Assignment](https://testorchestrator.com/docs/workflows/project-assignment) — Decide which projects offer a state — all of them, or a chosen few.
- [Workflow Automation](https://testorchestrator.com/docs/workflows/automation) — The include-in-runs set, the four fixed rules, and which of them take effect today.
