Test Suites

A test suite is a collection of test cases that run together. Use suites to group related tests — for example, all checkout tests, all authentication tests, or a full regression suite.

Creating a Test Suite

1. Navigate to Suites in the sidebar
2. Click New Suite
3. Name your suite (e.g., "Checkout Regression Suite")
4. Add test cases to the suite

You can add or remove test cases from a suite at any time. A single test case can belong to multiple suites.

Custom Execution Flow

By default, all test cases in a suite run sequentially in order. Enable Custom Execution Flow to take full control over how tests execute using the visual flow builder.

Execution Groups

The flow builder organizes test cases into groups. Groups execute in order — when one group finishes, the next begins. Each group has its own execution mode:

• Sequential — Test cases in the group run one after another
• Parallel — Test cases in the group run concurrently

Toggle a group's mode by clicking the Sequential / Parallel badge on the group card.

Building a Flow

1. Enable custom execution flow from the suite page
2. Click Add Group to create execution groups
3. Drag test cases from the Unassigned palette on the right into groups
4. Reorder test cases within groups by dragging
5. Optionally name each group for clarity
6. Click Save Flow once all test cases are assigned

All test cases must be assigned to a group before saving. A suite supports up to 20 groups with up to 50 test cases per group.

Scheduling

Set up recurring test runs from the suite settings:

1. Open a test suite
2. Go to suite settings and click Schedule Tests
3. Select which days to run (quick presets: weekdays, every day, weekends)
4. Choose a mode:
   • Specific times — Pick up to 6 hours of the day
   • Interval — Run every X hours or minutes
5. Save the schedule

The dialog shows a preview of the next upcoming runs in your team's timezone. Scheduled runs execute automatically and appear in the Runs page with a "Scheduled" trigger type.

Suite Settings

Each suite has configurable settings:

• Environment — Which environment to run tests against (staging, production, custom)
• Browser — Chromium, Firefox, or WebKit
• Notifications — Email notifications on completion
• Retry policy — Whether to automatically retry failed tests

Running a Suite

You can trigger a suite run in several ways:

• Manual — Click "Run Suite" from the suite page
• Scheduled — Runs automatically based on your configured schedule
• CI/CD — Trigger via API from your deployment pipeline (see CI/CD Integration)

When a suite runs, it creates a suite run containing individual test runs for each test case. View results in Test Runs & Suite Runs.