By definition, a test environment is an environment that contains all necessary elements, including the SUT, so you can perform testing on it.

Depending on your context, a test environment may represent:

  • a testing stage (e.g. "development", "staging", "preproduction", "production")
  • a device model or device operating system (e.g. "Android", "iOS")
  • an operating system (e.g. "Windows", "macOS", "Linux")
  • browser (e.g. "Edge", "Chrome", "Firefox")

In Xray, Test Environments are focused on the execution aspect, providing the means to schedule tests and analyze their results in different environments.

Create New Test Environments

Go to Jira Settings > Apps > Xray > Test Environments

To create a new Test Environment, click on Create Environment, fill out the following fields and then press Save:

  • Name: the name for the Test Environment (a string of 2 up to 18 non-space characters)
  • Description: the description for the Test Environment
  • URL: the URL of the Test Environment



Test environments, that are created in the Global Xray Settings, will be available to be re-used at all Projects. Nevertheless, you need to explicitly add them to Projects. 



Add Test Environments to Project

After creating the Test Environment at the Global Settings, you need to explicitly add it to your Project. 

Go to our Project > Project Settings > Xray Settings > Test Environments


  1. Click Add Environment.
  2. Search the globally available Test Environments, either by using the dropdown picker or by using autocomplete.
  3. Select the Test Environment you want and click Save.


As this operation is done at the Project Settings, you can ask your project administrator to add the Test Environments, or even create new ones themselves. 

When creating a Test Environment locally, it will not be available at Global Test Environments to be picked up in another project.