Organize Tests into Groups
Groups collect tests that should run together. Create groups around a purpose, such as Critical flows, Checkout, or Release smoke tests.
Groups are required for:
- Pull request regression testing.
- CI and deployment webhooks.
- Scheduled production monitoring.
- Running several tests with one action.
Create a group
- Open your project and select Tests.
- Create a New Group.
- Enter a clear name, such as
Critical flows. - Add existing tests to the group from each test’s Groups control.
A test can belong to more than one group. This lets a checkout test run in both Critical flows and Payments without duplicating the test.
Choose the right scope
Keep groups focused on one release decision or operational concern:
Avoid one large group containing every test. Smaller groups make failures easier to understand and let you run only the relevant coverage.
Enabled and disabled tests
Automated group runs execute enabled tests and skip disabled tests. Disabled tests remain available for manual runs.
Configure group execution
Groups run tests concurrently by default. Use Run Mode when tests must execute sequentially, and add a Preparation Test when web tests should share authenticated or seeded browser state.
Add a trigger
After a group runs successfully by hand, choose how it should run automatically:
- Select it under GitHub pull request regression testing.
- Enable its signed webhook for GitLab CI or another deployment pipeline.
- Select it in Production Monitoring for recurring checks.
