Specify a Cypress version

Learn about the versions of Cypress we support and how to configure your builds.

As Cypress versions are released, it is recommended that your test scripts use the latest version to benefit from the recent enhancements and bug fixes. The Cypress versions are defined using the .latest format such that your test scripts always use the latest minor version.

Also, when Cypress versions are set as 6, 7, 8, 9, 10, 11, 12, or 13 BrowserStack uses the latest minor version to run the tests.

You will learn:

• Which Cypress versions we support
• How to set Cypress version in code

Supported Cypress versions

We support the latest major versions of Cypress, namely v6, v7, v8, v9, v10, v11, v12, v13 versions. If you want your test scripts to always use the latest Cypress minor version, set the version to either 13.latest or 13 for v13, 12.latest or 12 for v12, 11.latest or 11 for v11, 10.latest or 10 for v10, 9.latest or 9 for v9, 8.latest or 8 for v8, 7.latest or 7 for v7, and 6.latest or 6 for v6.
From Cypress v13, the video configuration option now defaults to false.

The following table lists the supported Cypress versions and how they must be defined in the browserstack.json file.

Set the Cypress version

Set the cypress_version key to the required version as the value in the browserstack.json file.

In browserstack.json, set the cypress version as seen in the following code snippet.

// browserstack.json
{
  ...
  "run_settings": {
      ...
      "cypress_version": "13.latest",
      ...
    }
  ...
}

If you have a use case where you need to use a Cypress version other than the one we support, contact us.