Running Tests with the Test Runner Wizard
The Test Runner Wizard provides a guided environment for executing test cases manually. It walks you through each test case step-by-step, lets you record verdicts with optional failure notes, and automatically creates a launch record with the results.
Prerequisites
- A Test Plan with test cases assigned
- Editor role or above on the project
Starting a Test Run
- Navigate to Test Plans in the project sidebar
- Open the test plan you want to execute
- Click Launch Wizard (or the equivalent action button)
- The wizard opens at
/project/[slug]/wizard/[testPlanSeq]
Configuring the Run
Before submitting the first verdict, select:
- Environment — choose the deployment environment being tested (e.g., staging, production)
- Language — the locale for this test run
TIP
Environment and language are locked after you submit the first verdict. Make sure to set them correctly before starting.
Navigating the Interface
The wizard uses a two-panel layout:
Left Panel — Case List
- All test cases from the plan, grouped by suite
- Each case shows a status icon (pending, passed, failed, blocked, skipped)
- Search bar to filter cases by name or sequence number
Right Panel — Case Detail
- The currently selected case name, priority, test type, suite, and description
- Numbered step list with step type indicators
- Shared steps appear as expandable sub-step groups
Use the ← → arrows at the bottom to move between cases, or click any case in the left panel to jump directly to it.
Recording Verdicts
At the bottom of the case detail panel, four verdict buttons are available:
| Verdict | When to Use |
|---|---|
| Passed | The case executed as expected |
| Failed | The case did not produce the expected result |
| Blocked | The case could not be executed due to an external blocker |
| Skipped | The case was intentionally not executed |
When you click Failed, a dialog appears asking for a failure reason. Describe what went wrong in the text area before confirming.
INFO
After submitting a verdict, the wizard automatically advances to the next pending case.
Using the Timer
A timer at the top shows elapsed time for the run. Click Pause to pause and Play to resume. The elapsed time is recorded in the launch.
Searching Cases
Use the search bar in the left panel to find specific cases by name or sequence number. This is useful for large test plans.
Finalizing the Launch
When all cases have a verdict, a green banner appears: "All cases completed!" Click Finalize Launch to close the run and navigate to the Launch Detail page with the full results.
Deleting an In-Progress Run
If you need to abandon the run, click the ... menu and select Delete Launch. This permanently removes the in-progress launch.
WARNING
Deleting an in-progress launch is permanent. All recorded verdicts will be lost.