#Managing Parameters
Parameters are reusable values that can be referenced across test cases, steps, executions, and other entities using the $ syntax. Once created, parameters can be edited, tracked, and safely removed with full visibility into their usage.
This guide explains how to manage parameters after creation.
#Accessing Parameters
Parameters are managed from the top navigation:
- Go to Configuration → Parameters
- Switch between Workspace and Project scope as needed
Workspace parameters are global and automatically available in all projects.
Project parameters are scoped only to the selected project.
#Viewing Parameter Details
Click on a parameter to open the Parameter Details panel.
You can view:
- Name – Identifier used during insertion
- Value – The actual resolved value
- Description – Context for usage
- Scope – Workspace or Project
- Usage count – Where the parameter is currently referenced
#Editing Parameters
You can edit:
Changes are applied immediately and reflected everywhere the parameter is used.
Editing a parameter does not break existing references.
#Deleting Parameters (Important)
When a parameter is in use, Hawzu prevents unsafe deletion. Instead, you must choose how existing usages should be handled.
#Delete Options
When deleting a parameter, Hawzu shows:
- Total number of usages
- The types of entities affected (test cases, steps, etc.)
You must choose one of the following actions:
#1. Replace with Another Parameter
Best for migrations
- Select an existing parameter
- All references are updated automatically
- No content is lost
Use when:
- Renaming parameters
- Consolidating multiple parameters
- Replacing deprecated parameters
#2. Replace with Static Value
Best for finalizing content
- Provide a fixed value
- Parameter references are replaced with plain text
- The content becomes independent of parameters
Use when:
- The value will no longer change
- You want to remove indirection
#3. Remove from Usages
Destructive action
- Removes the parameter reference entirely
- Leaves the surrounding content intact
- May result in incomplete or invalid steps
Use when:
- Cleaning up unused placeholders
- You plan to manually update content later
⚠️ This option cannot be undone.
#Deleting Unused Parameters
If a parameter has no usages, it can be deleted immediately without any replacement action.
#Workspace vs Project Behavior
#Workspace Parameters
- Automatically available in all projects
- Deleting affects all projects
- Replacement actions apply globally
#Project Parameters
- Scoped to a single project
- Deletion affects only that project
- Safe to experiment without global impact
#Best Practices
- Prefer Replace with another parameter over removal
- Review usage before deleting
- Avoid deleting workspace parameters casually
- Use descriptions to clarify intent
- Periodically clean up unused parameters
#Next Steps