Skip to main content

Environments

Environments store reusable parameters - such as base URLs - that you attach to a test case and reference in steps. Use one environment with multiple parameter values so the same steps can target QA, UAT, or other configs without rewriting the case.

Pair environments with Data profiles for parameterized test data. Organize suites under Projects and run them with Cloud Execution.

Environments listEnvironments list

Click Environments in the left sidebar to see all environments.

Name
The environment name. Click to open.
Updated By
Who last edited it.
Updated Date
When it was last changed.
Actions
Delete the environment.

How to create an EnvironmentHow to create an Environment

  1. Go to Environments

    Go to Environments in the sidebar.

  2. Create

    Click + Create Environment in the top right.

  3. Name the environment

    Enter a name - for example staging or production.

How to delete an EnvironmentHow to delete an Environment

Click the red trash icon in the Actions column and confirm deletion.

ParametersParameters

When you open an environment, the Parameters tab is shown by default. Parameters are key-value pairs - for example a Parameter Name of QA with a Parameter Value of https://qa.qality.dev.

Parameter Name
The key you reference in a test step - for example QA or UAT.
Parameter Value
The value substituted at runtime - often a URL such as https://qa.qality.dev.
note

If a parameter has no value it shows as -. Always set a value before running test cases with this environment.

How to add a ParameterHow to add a Parameter

  1. Open an environment

    Open an environment from the list.

  2. Parameters tab

    Stay on the Parameters tab.

  3. Add

    Click + Add.

  4. Enter values

    Enter the Parameter Name and Parameter Value.

  5. Save

    Save.

Using an Environment in a test caseUsing an Environment in a test case

Use this flow after you have created an environment and added parameters (including URLs):

1
Select the Environment on the test case

Open the test case. In the Test Case Overview side panel, set Environment to the environment you created (for example env-1). You can also set Data Profile here when you use one.

2
Add or edit a step value

In Test Steps, type or edit a value such as a URL or label. Highlight the part you want to parameterize.

3
Choose Environment from the menu

From the menu choose Environment (shown as *|Environment|). You can also choose Plain Text or Parameter (@|Parameter|) when you need a different value type.

4
Use the parameter name in the step

The step shows the environment parameter in this form: *|parameter_name|. Example: Navigate to *|QA| uses the QA parameter value from the selected environment (such as https://qa.qality.dev).

tip

Use environment parameters for values that change by target - base URLs, credentials, API endpoints, or config keys. Keep the Parameter Name short and clear so it is easy to pick in steps.

note

Environments are created manually - they are not created by the recorder.

Best practicesBest practices

  • Name environments clearly - env-1, staging, production
  • Add URL parameters for each target you need - for example QA and UAT
  • Select the Environment on the test case side panel before you run
  • Always set values for all parameters before running
  • Delete unused environments to keep the list clean