Skip to main content
Cypress 10 support is here! Upgrade your BrowserStack Cypress-CLI to v1.18.0 and start testing. Try now!

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, or 10 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, and v10 versions. If you want your test scripts to always use the latest Cypress minor version, set the version to either 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.

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…
10.3.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. 10.latest or 10 to run tests on 10.3.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
Note: Check out Supported Cypress versions for the complete list of supported versions.

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

// browserstack.json
{
  ...
  "run_settings": {
      ...
      "cypress_version": "10.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
Talk to an Expert