#Managing Shared Steps
Shared Steps allow teams to reuse common test logic across multiple test cases. Managing them correctly ensures consistency, reduces duplication, and prevents accidental breakage across projects.
This guide explains how to view, edit, and delete shared steps in Hawzu.
#Accessing Shared Steps
Shared Steps are available from the top navigation: Configuration → Shared Steps
Depending on where you open this from:
- Workspace context → Manage workspace shared steps
- Project context → Manage project shared steps for that project
#Workspace vs Project Shared Steps
#Workspace Shared Steps
- Created at the workspace level
- Automatically available in all projects
- No enable/disable or scoping required
- Ideal for:
- Login flows
- Environment setup
- Common validations
- Cross-project standards
Any update to a workspace shared step is reflected immediately across all projects where it is used.
#Project Shared Steps
- Created inside a specific project
- Available only within that project
- Ideal for:
- Feature-specific flows
- Project-only logic
- Temporary or experimental steps
Project shared steps do not affect other projects.
#Viewing Shared Step Details
Clicking a shared step opens the Shared Step Details view.
You can see:
- Name – Shared step name
- Description – Optional explanation
- Steps
- Step description
- Expected output
- Usage information (where the step is referenced)
This view is read-only until you enter edit mode.
#Editing Shared Steps
To edit a shared step:
- Open the shared step
- Click Edit
- Update:
- Name
- Description
- Step descriptions
- Expected outputs
- Click Save
#Important Behavior
- Changes apply everywhere the shared step is used
- Existing test cases automatically reflect updates
- There is no per-testcase override for shared steps
#Deleting Shared Steps
Deleting a shared step is a guided and safe operation.
If a shared step is used in test cases, Hawzu shows:
- Number of usages
- Impacted entities (test cases, executions)
You must choose one of the following actions.
#Delete Options
#1. Remove Shared Step from Usages
- Removes the shared step reference
- Affected test cases lose that step
- No replacement content is added
Use this when:
- The step is obsolete
- It should be removed completely
#2. Convert Shared Step to Regular Steps
- Replaces the shared step with normal test steps
- Step content is copied into each test case
- Test cases become independent of the shared step
Use this when:
- You want to preserve existing behavior
- But no longer want shared maintenance
#What You Cannot Do
- You cannot delete a shared step without selecting a delete strategy
- You cannot partially edit a shared step for one test case
- You cannot scope workspace shared steps to specific projects
#Best Practices
- Use workspace shared steps for globally reusable logic
- Use project shared steps for project-specific flows
- Keep shared steps focused and concise
- Avoid embedding environment-specific data in workspace shared steps
- Prefer converting to regular steps over hard removal when unsure
#Summary
Shared Steps in Hawzu are:
- Globally reusable (workspace)
- Safely scoped (project)
- Automatically propagated
- Protected from accidental breakage
This ensures consistency without sacrificing control.
#Next Steps