Shared Steps Overview
2 min read
Shared steps are reusable groups of test steps. They help teams keep repeated flows consistent without copying the same step descriptions and expected results into every test case.
What Shared Steps Do
Section titled “What Shared Steps Do”A shared step has a Name, optional Description, and one or more step rows. Each row can include:
- Step Description
- Expected output
- Rich text
- Parameters
- Mentions
- Attachments
After a shared step is inserted into a repository test case, it remains linked to the shared step definition. Updates to the shared step can appear wherever that linked shared step is used.
Workspace and Project Shared Steps
Section titled “Workspace and Project Shared Steps”Hawzu supports shared steps at two levels:
- Workspace shared steps are available across projects in the workspace.
- Project shared steps are available only inside the selected project.
On a project Shared Steps page, Hawzu can show both workspace and project shared steps. The Scope column and scope filter help identify where each shared step comes from.
Learn more in Workspace vs Project Scope.
Where Shared Steps Are Used
Section titled “Where Shared Steps Are Used”Shared steps are used in repository test cases. While creating or editing a test case, users can open the Insert Shared Step window, choose a shared step, preview its rows, and add it to the test case.
Learn more in Using Shared Steps in Test Cases.
Shared Steps Page
Section titled “Shared Steps Page”The Shared Steps page helps teams create, review, and manage reusable step groups.
The table can show:
- Name
- Description
- Scope on project pages
- Usages
- Created On
- Actions
You can search shared steps, filter the table, sort by key fields, change visible columns, adjust page size, and open a shared step details view.
Safe Lifecycle
Section titled “Safe Lifecycle”Shared steps are designed for careful reuse:
- Creating a shared step makes it available in the selected workspace or project area.
- Editing a shared step updates the linked shared-step content wherever it is used.
- Deleting a used shared step requires choosing what happens to linked test cases.
- Converting to regular steps keeps step content in the test cases without keeping the shared link.
Learn more in Delete Shared Steps.
Permissions
Section titled “Permissions”Available actions depend on your workspace or project access. Users may be able to view shared steps without being able to create, edit, remove, or delete them.
Workspace-level shared-step changes can affect multiple projects, so Hawzu limits these actions to users with the right access.