Creating a Run
The Create Run modal has two tabs — Run for metadata and Notes for a rich-text briefing. Fill in the essentials, choose which test cases to include, and click Create.
Think of it as setting up race day
You name the event (title), assign it to a race series (cycle), set the course conditions (environment), tag it for easy filtering, and pick which athletes compete (test case selection). The Notes tab is your event briefing — use it for test plans, setup instructions, or acceptance criteria.
Step by step
- Click New Run in the top-right corner of the TEST RUNS tab.
- Enter a Title for the run. This is the only required field.
- Optionally select a Cycle to group the run under a sprint, release, or iteration.
- Optionally select a Lifecycle State to set the run’s initial state (e.g. Planned).
- Optionally select an Environment to record which platform combination is being tested.
- Optionally add one or more Tags for categorisation and filtering.
- Switch to the Notes tab to add a rich-text briefing — test plans, setup instructions, or acceptance criteria.
- Choose which test cases to include: enable Include All Cases for a full regression, or click the selection button to open the case selection modal and pick a precise subset.
- Click Create.
Run metadata fields
| Field | Required | Description |
|---|---|---|
| Title | Yes | A short name for the run — e.g. “Sprint 12 Regression” or “Login Flow Smoke Test”. Maximum 255 characters. |
| Cycle | No | The cycle this run belongs to. Only active and upcoming cycles appear in the dropdown. See Cycles. |
| Lifecycle State | No | The run’s current state. Choose from the Runs lifecycle states defined in Lifecycles. |
| Environment | No | The platform/browser combination under test. Choose from environments defined in Environments. |
| Tags | No | One or more labels for categorisation. Choose from tags defined in Tags. |
| Notes | No | A rich-text description on the Notes tab. Supports formatting, inline images, and links. |
Including test cases
You have two approaches:
- Include All Cases
- Enable the Include All Cases toggle to pull every test case from the project repository into the run. This is the quickest option for a full regression pass.
- Case selection modal
- Disable the toggle and click the selection button to open the case selection modal. This lets you build a precise subset using folders, filters, and match modes. See Selecting Test Cases for full details.
You can adjust the case selection later by editing the run. Open the run’s three-dot menu, click Edit, and modify the selection.
The Notes tab
The Notes tab provides a rich-text editor with formatting tools — bold, italic, lists, headings, code blocks, links, and inline images. Use it to document:
- The test plan or scope of the run
- Environment setup instructions
- Acceptance criteria or exit conditions
- Links to related design documents or tickets
What happens on save
When you click Create, the run is saved with 0 % progress. The selected test cases are snapshotted into the run at that moment.
Snapshot at creation time. Creating a run captures the selected test cases as they exist right now. If you later add, edit, or delete test cases in the repository, those changes are not reflected in existing runs. To include new cases, edit the run and update the case selection.