# Test Suites

Group related scenarios into suites, the unit you run, schedule, and track a pass rate against.

<TestSuitesScreen />

**Path:** Trust Lab → Test Suites (second icon)

Test Suites group related [scenarios](/user-guides/trust-lab/scenarios/) together. A suite is the unit you run, schedule, and track pass rates against.

## Suite list

Each row shows:

| Column | Description |
| :--- | :--- |
| **Name** | Suite name (e.g., "Sanity") |
| **Scenarios** | Number of scenarios in the suite |
| **Status** | Passed or Failed |
| **Passed** | Ratio of passing scenarios (e.g., "3/3") |
| **Last Success** | Timestamp of the last fully passing run |
| **Last Run** | Timestamp of the most recent run (pass or fail) |
| **Recent Runs** | Visual mini-history of recent outcomes (colored dots) |

Each row has two action icons: **History** (view past runs for this suite) and **Run** (trigger an immediate manual run).

## Suite detail view

<SuiteDetailScreen />

Click a suite name to open its detail page. The header shows:

| Card | Description |
| :--- | :--- |
| **Scenarios** | Total number of cases in this suite |
| **History** | Number of recorded suite executions |
| **Last Run** | Pass ratio and time of the most recent run (e.g., "3/3 — Triggered about 3 hours ago") with a green progress bar |
| **Passing** | Number of scenarios whose latest result is passing |

The **Scenarios table** lists each scenario with its latest result, last run time, last success, step count, and a recent runs dot-history. Click the arrow icon on any scenario row to open that [scenario's editor](/user-guides/trust-lab/scenarios/#the-scenario-editor) directly.

The **Suite History table** below shows every past execution of the suite, including who triggered it, the pass rate, trigger type (Manual or Scheduled), and the exact start time. Click **Open Latest** to jump directly to the most recent run's detail.

From the top-right, suite actions let you:

- **Add Existing**: add an already-created scenario to this suite.
- **+ New Scenario**: create a new scenario and automatically add it to this suite.
- **Run Suite**: execute all scenarios in the suite immediately.

## Creating a test suite

Click **+ New Suite** in the top-right of the Test Suites list. Give the suite a name (e.g., "Sanity", "Regression", "Onboarding Flows"), then add existing scenarios to it.

:::note[Start small]
Start with a Sanity suite containing your most critical 3–5 scenarios. Run it before every production deployment.
:::