AutomateSet up test environmentConfigure browsers and devicesSelect browsers and devices

Select browsers and devices

Learn about the capabilities that you can use to run tests on a particular browser / OS.

BrowserStack SDK
Legacy Integration

Following are a list of capabilities which can you can use to specify which browser / OS / device combination you want to run your test on:

Capability	Description	Expected values
`browserName`	Browser you want to test on	`Chrome`, `Firefox`, `IE`, `Safari`, `Edge`, `Opera`
`browserVersion`	Browser version you want to test	By default, we run tests on latest stable version of specified browser. View the list of supported browser versions. You can also use `latest-beta`, `latest`, `latest - 1`, `latest - 2`, etc., to test on the current beta release or latest n versions of the specified browser as you specify.
`os`	OS you want to test on	`Windows`, `OS X`
`osVersion`	Version of the OS to test on	Windows: `XP`, `7`, `8`, `8.1`, `10` and `11` OS X: `Snow Leopard`, `Lion`, `Mountain Lion`, `Mavericks`, `Yosemite`, `El Capitan`, `Sierra`, `High Sierra`, `Mojave`, `Catalina`, `Big Sur`, `Monterey`, `Ventura`, `Sonoma` and `Sequoia`
`deviceName`	Mobile or tablet to test on	The device you want to test on. View the list of devices we support.

You can use these capabilities as shown in the following example:

Set platforms to test on

Select the browsers / devices you want to test under the platforms object.

For testing on the Chromium browser on an iOS device running iOS 14 or higher, please refer this page.

Sample script showing capability declarations for browser-OS combinations

```yml
userName: YOUR_USERNAME
accessKey: YOUR_ACCESS_KEY
platforms:
  - YOUR_FIRST_OS_TYPE: YOUR_FIRST_OS
    YOUR_FIRST_OS_VERSION_TYPE: YOUR_FIRST_OS_VERSION
    YOUR_FIRST_BROWSER_TYPE: YOUR_FIRST_BROWSER
    YOUR_FIRST_BROWSER_VERSION_TYPE: YOUR_FIRST_BROWSER_VERSION
  - YOUR_SECOND_OS_TYPE: YOUR_SECOND_OS
    YOUR_SECOND_OS_VERSION_TYPE: YOUR_SECOND_OS_VERSION
    YOUR_SECOND_BROWSER_TYPE: YOUR_SECOND_BROWSER
    YOUR_SECOND_BROWSER_VERSION_TYPE: YOUR_SECOND_BROWSER_VERSION
  - YOUR_THIRD_OS_TYPE: YOUR_THIRD_OS
    YOUR_THIRD_OS_VERSION_TYPE: YOUR_THIRD_OS_VERSION
    YOUR_THIRD_BROWSER_TYPE: YOUR_THIRD_BROWSER
    YOUR_THIRD_BROWSER_VERSION_TYPE: YOUR_THIRD_BROWSER_VERSION
YOUR_LOCAL_CAPS_TYPE: YOUR_LOCAL_CAPS
YOUR_BUILD_NAME_TYPE: YOUR_BUILD_NAME
YOUR_BUILD_IDENTIFIER_KEY: YOUR_BUILD_IDENTIFIER_TYPE
YOUR_PROJECT_NAME_TYPE: YOUR_PROJECT_NAME
YOUR_DEBUG_CAPS_TYPE: YOUR_DEBUG_CAPS
YOUR_NETWORK_CAPS_TYPE: YOUR_NETWORK_CAPS
YOUR_CONSOLE_CAPS_TYPE: YOUR_CONSOLE_CAPS
```
browserstack.yml

      
      
    

        
            Copy icon
            
          
        Copy
      
    userName: YOUR_USERNAME
accessKey: YOUR_ACCESS_KEY
platforms:
  - os: Windows
    osVersion: 10
    browserName: Chrome
    browserVersion: 120.0
  - os: OS X
    osVersion: Monterey
    browserName: Safari
    browserVersion: 15.6
  - deviceName: iPhone 13
    osVersion: 15
    browserName: Chromium
    deviceOrientation: portrait
browserstackLocal: true
buildName: bstack-demo
buildIdentifier: ${BUILD_NUMBER}
projectName: BrowserStack Sample
debug: true
networkLogs: true
consoleLogs: info

  

Capability	Description	Expected values
`browser`	Browser you want to test on	`Chrome`, `Firefox`, `IE`, `Safari`, `Edge`, `Opera`
`browser_version`	Browser version you want to test	By default, we run tests on latest stable version of specified browser. View the list of supported browser versions. You can also use `latest-beta`, `latest`, `latest - 1`, `latest - 2`, etc., to test on the current beta release or latest n versions of the specified browser as you specify.
`os`	OS you want to test on	`Windows`, `OS X`
`os_version`	Version of the OS to test on	Windows: `XP`, `7`, `8`, `8.1`, `10` and `11` OS X: `Snow Leopard`, `Lion`, `Mountain Lion`, `Mavericks`, `Yosemite`, `El Capitan`, `Sierra`, `High Sierra`, `Mojave`, `Catalina`, `Big Sur`, `Monterey`, `Ventura`, `Sonoma` and `Sequoia`

Capability	Description	Expected values
`deviceName`	Mobile or tablet to test on	The device you want to test on. View the list of devices we support.
`osVersion`	Version of the OS to test on	Check the OS versions available for the specified device

Capability	Description	Expected values
`device`	Mobile or tablet to test on	The device you want to test on. View the list of devices we support.
`os_version`	Version of the OS to test on	Check the OS versions available for the specified device

Did this page help you?

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

This page has exactly what I am looking for
This content & code samples are accurate and up-to-date
The content on this page is easy to understand
Other (please tell us more below)

Any additional feedback?

Thank you for your valuable feedback

Is this page helping you?

Yes

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

This page has exactly what I am looking for
This content & code samples are accurate and up-to-date
The content on this page is easy to understand
Other (please tell us more below)

Any additional feedback?

Thank you for your valuable feedback!

Select browsers and devices

Set platforms to test on

Sample script showing capability declarations for browser-OS combinations

BrowserStack-specific capabilities (Desktop)

Sample script showing capability declarations for desktop browsers

Sample script showing capability declarations for desktop browsers

BrowserStack-specific capabilities (Mobile)

Sample script showing capability declarations for mobile devices

Sample script showing capability declarations for mobile devices

Capability rules

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

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

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

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