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