Skip to main content
Transform your testing process with: Real Device Features, Company-wide Licences, & Test Observability

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:

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.

Supported Cypress versions Set in browserstack.json as…
13.3.3 13.latest or 13
12.17.0 12.latest or 12
11.2.0 11.latest or 11
10.8.0 10.latest or 10
9.6.1 9.latest or 9
8.7.0 8.latest or 8
7.6.0 7.latest or 7
6.8.0 6.latest or 6

Set the Cypress version

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

Key Description Possible values
cypress_version Set the required Cypress version. 13.latest or 13 to run tests on 13.3.3
12.latest or 12 to run tests on 12.17.0
11.latest or 11 to run tests on 11.2.0
10.latest or 10 to run tests on 10.8.0
9.latest or 9 to run tests on 9.6.1,
8.latest or 8 to run tests on 8.7.0,
7.latest or 7 to run tests on 7.6.0,
6.latest or 6 to run tests on 6.8.0

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

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

If you have a use case where you need to use a Cypress version other than the one we support, please reach out to our Support team.

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked






Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked






Thank you for your valuable feedback!

Talk to an Expert
Download Copy