As your tests grow, a flat list of steps can become difficult to navigate. With step groups, you can bundle related steps together under a shared name. For example, you might group a sequence of click, type, and submit steps under a name like “Log in” or “Fill out payment form”. Step groups are a great way to give your tests a clear, scannable structure to your browser and mobile tests.
Create a step group
To create a step group:
- Open a browser or mobile test in the Trainer.
- Click + (Add step) at the position where you want the group.
- Select Step group.
- Enter a descriptive name for the group, such as “Navigate to checkout” or “Verify order confirmation.”
The step group is created as an empty container. You can populate it by recording new steps, dragging existing steps into it, or using the + (Add step) menu while your cursor is inside the group.
Add steps
Step groups can contain any step type, including clicks, assertions, JavaScript steps, API steps, and flows.
There are three ways to add steps to a step group:
- Record into a group - position your cursor inside the step group, and record steps as usual. New steps are automatically added within the group.
- Drag and drop - drag existing steps into a step group to move them inside it. You can also drag steps out of a group to remove them.
- Use the add-step menu - click + (Add step) while your cursor is inside a step group to add any step type directly.
Step groups and flows
Step groups and flows can be freely combined:
- Place flows inside step groups to wrap reusable building blocks in descriptive context.
- Place step groups inside flows to organize complex shared flows into navigable sections.
For guidance on when to use step groups, flows, or both, see Step groups vs. flows.
Nesting step groups
Step groups can be nested inside other step groups. Each nesting level has a distinct color-coded indent bar so you can visually distinguish hierarchy depth. The maximum depth of nested step groups is 4.
Limitations
- Step groups are available for browser and mobile tests only.
- Loops are not supported in step groups. To loop through a set of steps, use a flow.
- Parameters are not supported on step groups. To scope variables to a specific set of steps, use a flow.
- Unlike tests and flows, step groups do not have independent versioning.