TestOwl LogoTestOwlDocs

Environments Overview

An Environment defines how TestOwl runs your tests. It contains the configuration required to execute a test, such as the browser, device, viewport, location, timezone, network settings, and other runtime options.

A single test can be executed across multiple environments to verify that your application works consistently across different browsers, devices, and configurations.

“Build once. Test across every browser, device, and environment.”

— TestOwl Team

Creating an environment

To create an environment:

  1. 1
    Open Environments from the sidebar.
  2. 2
    Click New Environment.
  3. 3
    Configure the environment details.

The environment editor contains multiple tabs. Start with the General tab:

FieldDescription
NameA unique name used to identify the environment when running tests. Example: Production Chrome
DescriptionOptional information to help your team understand the purpose of the environment.
TypeDefines the environment category: Development, Staging, Production, or Others.

The remaining configuration options are organized into separate tabs:

Masking Rules are also configured from the environment editor.

Marking an environment as Production

An environment is considered a Production environment when its Type is set to Production in the General tab.

Production environments have an additional safety check: Draft-status test cases cannot be executed against them. This prevents unfinished tests from accidentally running against live applications.

Duplicating an environment

You can duplicate an existing environment to quickly create a similar configuration.

This is useful when creating variations such as:

  • The same staging setup with a different browser.
  • A desktop environment with a mobile device configuration.
  • Multiple environments that share most settings but differ in a few options.

After duplication, update only the settings that need to change.

Deleting and restoring environments

Deleted environments are moved to trash and can be restored within the 15-day retention period.

Selecting an environment when running tests

When you trigger a run, you can select one or more environments for execution.

Each selected environment runs independently and generates its own result. This makes it easy to identify environment-specific issues, such as a test failing only on mobile Safari or a particular browser version.

Next steps