Step Groups

Step Groups allow you to create a set of steps once and reuse them across multiple tests. This eliminates repetitive work and ensures consistency across your testing workflows.

Accessing Step Groups

To manage reusable steps, navigate to Step Groups in the left sidebar of your Qualiti workspace.

Here, you can:

• View all existing step groups
• Create new groups
• Edit, rename, or delete existing groups
• Add or remove steps within a group

tip

Each Step Group represents a reusable block of steps that can be inserted into any test in your Test Library.

Creating a Step Group

1. From the Step Groups tab, click + Add Step Group
2. Enter a name for your new group
3. Click Add Step to begin defining the steps within your group
4. Each step can be created or edited just like a normal test step
5. When finished, click Save Steps

Editing or Deleting Step Groups

• To edit a group (e.g., rename it), click the three-dot menu (⋯) next to its name and choose Edit
• To duplicate a group, click the three-dot menu (⋯) next to its name and choose Duplicate
• To edit steps within a group, click the group name to open it in the right pane, where you can:
  • Click + Add Step to add new steps
  • Use the three-dot menu (⋯) next to each step to Duplicate or Remove it
  • Edit step details directly in the step editor
• To delete a group, select Delete from the same menu

You can also reorder steps inside a group by dragging and dropping them, just as you do in regular tests.

Adding a Step Group to a Test

You can reuse your Step Groups in any test from the Test Library:

1. Open the test you want to edit
2. Switch to the Steps tab
3. Click + Add Step Group
4. Select a Step Group from the dropdown list
5. Click Add Steps to insert the group into your test
6. The added group will appear as a single block (labeled "Group"), showing its name within the test steps

note

Once inserted, the group steps run as part of the test in the same order they appear in the Step Group.

Updating Step Groups Used in Tests

When you update a Step Group (for example, changing one of its steps), the changes automatically apply to all tests that reference that group. This ensures consistent behavior across your test suite.

tip

If you delete a Step Group that's currently used in one or more tests, those references will be removed automatically.

Example: Using a Step Group for Form Filling

Let's say you frequently need to fill out a user registration form across different test scenarios.

You can:

1. Create a User Registration Step Group with steps like:
   • Navigate to registration page
   • Enter first name and last name
   • Enter email address
   • Select user role from dropdown
   • Click "Create User"
   • Verify success message appears
2. Insert that group into multiple tests (e.g., "Test User Permissions," "Verify Email Notifications," "Check User Dashboard")

Now, if your registration form fields change, you only need to update the User Registration Step Group once — all tests using it will reflect the change.

Running Tests with Step Groups

When you run a test that includes Step Groups:

• All steps inside the group are executed in sequence as part of the test
• Results appear in the test's Trace Viewer or Results tab as grouped actions
• Any failure inside the group displays which specific step failed within the block

Best Practices

Organizing Your Step Groups

• Use descriptive names that clearly indicate the group's purpose
• Group related steps together logically
• Keep step groups focused on single, specific workflows

Maintaining Step Groups

• Regularly review and update step groups as your application evolves
• Test step groups independently before using them in multiple tests
• Consider creating step groups for common workflows like navigation, form submissions, or data setup

When to Use Step Groups

• Use Step Groups for: Repetitive workflows, common setup steps, standard navigation patterns
• Avoid Step Groups for: One-off test steps, highly specific test scenarios, steps that change frequently