Add tenant parameters

Use tenant parameters to avoid managing the same parameter values in different places. They automatically apply to all your workspaces, playlists, and test cases. This gives your team a uniform starting point and reduces maintenance time and cost for duplicated parameter maintenance.

Before you start

To create tenant parameters, you must be an administrator.

Create a new tenant parameter

To create a new tenant parameter, follow these steps:

Go to Configurations > Parameters and select Create tenant parameters.
Enter your parameter details:

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

Column

Description

Parameter

The tenant parameter name:

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

Value

The tenant parameter value:

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

Data type

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

Select Save.

Understand inheritance

Tenant parameters define parameters values for your entire tenant.

This table explains what happens when you have the same parameter on multiple levels:

Parameter level	Override behavior	Application
Tenant	None.	Applies to all workspaces, playlists, and test cases in this tenant.
Workspace	Overrides tenant values.	Applies to all playlists and test cases in this workspace.
Playlist	Overrides test case, workspace, and tenant values.	Applies to all test cases in this playlist.
Test case	Overrides workspace and tenant values.	Applies to this test case only.

Edit or delete tenant parameters

You can edit or delete tenant parameters at any time. Simply go to Configurations > Parameters > Tenant 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 tenant parameters are all set. Next, you can take it a step further and set workspace parameters.