Add workspace parameters

Use workspace parameters to define reusable values for your test cases and apply them across your workspace. Instead of creating the same parameter in multiple playlists or test cases, define it once at the workspace level and reuse it.

Before you start

Before you create workspace parameters, keep the following in mind:

Only administrators and contributors can create, edit, and delete workspace parameters.
Workspace parameters apply only to the workspace where you create them.
Each workspace can have up to 100 workspace parameters.
If your administrator has set up tenant parameters, your workspace uses them by default. You can keep these values as they are or adjust them using workspace parameters. This way, your adjustments won't affect other workspaces.

Create a new workspace parameter

To create a new workspace parameter, follow these steps:

Go to Configurations > Parameters and select the Workspace parameters tab.
Select Create new parameter.
Enter your parameter details:

Column	Description
Parameter	The workspace parameter name: Custom parameter: Enter a custom, unique name. Special task parameter: Enter the special task parameter name. For a list of all the special task parameters, check out Supported parameters.
Value	The parameter value: Custom parameter: Enter a value for your worspace parameter. Special task parameter: Enter the special task parameter value. For a list of all the values available for special task parameters, check out Supported parameters.
Data type	Select the data type that matches your value: String, Boolean and Password.

Column

Description

Parameter

The workspace parameter name:

Custom parameter: Enter a custom, unique name.
Special task parameter: Enter the special task parameter name. For a list of all the special task parameters, check out Supported parameters.

Value

The parameter value:

Custom parameter: Enter a value for your worspace parameter.
Special task parameter: Enter the special task parameter value. For a list of all the values available for special task parameters, check out Supported parameters.

Data type

Select the data type that matches your value: String, Boolean and Password.

Select Save.

Understand inheritance

Tenant parameters provide default values for all your test cases. Workspace parameters inherit these values, so all playlists and test cases use them by default. To understand how parameter values are inherited and prioritized across levels, see Understand inheritance and override.

Reset overridden workspace parameters

To reset a workspace parameter to its default tenant value, follow these steps:

Go to Configurations > Parameters and select the Workspace parameters tab.
Select Create workspace parameters.
Choose the parameter and select Reset to default value.

Edit or delete tenant parameters

You can edit or delete workspace parameters at any time. Simply go to Configurations > Parameters > Workspace parameters and select the respective parameter.

Note that if you reference the value of a custom parameter in test cases, deleting that custom parameter will break those test cases. So, replace the test case values before you delete the parameter.

What's next

Your workspace parameters are all set. Next, you can take it a step further and set test case parameters.