We use cookies to enhance user experience, analyze site usage, and assist in our marketing efforts. By continuing to browse or closing this banner, you acknowledge that you have read and agree to our Cookie Policy, Privacy Policy and Terms of Service.

Browserstack logo
  • Live for Teams
  • Pricing
    • Test your websites
    • Live
      Interactive cross browser testing
    • Automate
      Selenium testing at scale
    • Percy
      Visual testing & review
    • Test your mobile apps
    • App Live
      Interactive native & hybrid app testing
    • App Automate
      Test automation for native & hybrid mobile apps
    • App Percy Beta
      Visual testing for native & hybrid mobile apps

    Use BrowserStack with your favourite products. See our Integrations ⟶

    • For Teams
    • Enterprise
    • Tools
    • Screenshots
    • Responsive
    • SpeedLab
    • Documentation
    • Support
    • Status
    • Release Notes
    • Open Source
    • Events
    • Champions
  • Live for Teams
  • Pricing
  • Sign in
  • Free Trial
  • Test your websites
  • Live
    Interactive cross browser testing
  • Automate
    Selenium testing at scale
  • Percy
    Visual testing & review
  • Test your mobile apps
  • App Live
    Interactive native & hybrid app testing
  • App Automate
    Test automation for native & hybrid mobile apps
  • App Percy
    Visual testing for native & hybrid mobile apps
  • For Teams
  • Enterprise
  • Tools
  • Screenshots
  • Responsive
  • SpeedLab
  • Documentation
  • Support
  • Status
  • Release Notes
  • Open Source
  • Events
  • Champions
  • Get help
  • Selenium documentation
  • NodeJS
  • Java
  • Python
  • C#
  • Ruby
  • Perl
  • PHP
  • WebdriverIO
  • Protractor
  • Nightwatch
  • JUnit
  • Test dev environments
  • Jenkins
  • References
  • Selenium Capabilities
  • Browsers & Devices
  • Continuous Integration (CI)
  • REST API
  • Status
  • Other frameworks
  • Cypress
  • Playwright
  • Puppeteer
  • JS Testing API
Home Documentation Automate Physical Mobile Devices

Automated testing on Physical Mobile Devices

BrowserStack supports automated browser testing via Selenium and Appium on real iOS and Android devices.

Note: Running your Selenium and Appium tests on BrowserStack Automate requires a username and an access key. To obtain your username and access keys, sign up for a Free Trial or purchase a plan.

Why test on Physical Mobile devices?

Running your test suite on physical mobile devices on the BrowserStack Real Device Cloud has several advantages. Here are some key ones:

  • Test on a real environment - Testing on a physical mobile device ensures that your tests are running on real world conditions. This reduces false positives, and makes it easier to replicate bugs users are having on their devices.
  • Better performance - Tests on physical mobile devices run much faster when compared to emulators/simulators, resulting in significantly faster build times.
  • Parallel testing - By harnessing the scale of BrowserStack's Real Device Cloud, you can run many tests in parallel, resulting in a significant reduction of your test times.

Getting Started

Testing on physical mobile devices requires just a few changes to your test scripts. You will need to pass the flag realMobile and specify which device you want to test on. Refer to the table below:

Capabilities:

Capability Values
realMobile

Use this flag to test on a physical mobile device.

true, false
Default: false
device

Specifies a particular mobile device for the test environment.

You can find a full list of supported devices here
os_version

Use this capability to specify the OS version of the device.

The os_version capability is compulsory for JS testing
browserstack.appium_version

Use this capability to set the Appium version in your test scripts.

Android: 2.0.0 , 1.22.0 , 1.21.0 , 1.20.2 , 1.19.1 , 1.18.0 , 1.17.0 (default on Android 5 and above), 1.16.0 , 1.15.0 , 1.14.0 , 1.13.0 , 1.12.1 , 1.8.0 (default on OS version 4.4)
iOS: 2.0.0 , 1.22.0 , 1.21.0 , 1.20.2 , 1.19.1 , 1.18.0 , 1.17.0 (default on iOS 12, 13 and 14), 1.16.0 , 1.14.0 , 1.13.0 , 1.12.1 , 1.8.0 , 1.7.0 (default on iOS 10 and 11)

Note: All values are strings.

Local Testing

Local Testing allows you to test your private and internal servers on BrowserStack cloud. You can also use Local Testing to test web applications located behind firewalls, or web applications accessed through proxies.

Local testing is supported on Physical Mobile devices. View Documentation

Have questions? We are happy to help. Contact us

In This Article

  • Why test on Physical Mobile devices?
  • Getting Started
    • Capabilities
    • Local Testing

Related Articles

Debugging Tools

Browsers & Devices

Capabilities

Timeouts

REST API

JS Testing

Local Testing

Continuous Integration

Travis CI

TeamCity

Products

  • Live
  • Automate
  • Percy
  • App Live
  • App Automate
  • App Percy Beta
  • Screenshots
  • Responsive
  • Enterprise
  • SpeedLab New!

Platform

  • Browsers & Devices
  • Data Centers
  • Device Features
  • Security

Solutions

  • Test on iPhone
  • Test on iPad
  • Test on Galaxy
  • Test In IE
  • Android Testing
  • iOS Testing
  • Cross Browser Testing
  • Emulators & Simulators
  • Selenium
  • Cypress
  • Android Emulators
  • Visual Testing

Resources

  • Test on Right Devices
  • Support
  • Status
  • Release Notes
  • Case Studies
  • Blog
  • Events
  • Test UniversityBeta
  • Champions
  • Mobile Emulators
  • Guide
  • Responsive Design
  • Nightwatch

Company

  • About Us
  • Customers
  • Careers We're hiring!
  • Open Source
  • Partners
  • Press
BrowserStack Logo An illustrated of BrowserStack Logo

Social

  • BrowserStack Twitter Account An illustrated of white twitter Logo
  • BrowserStack FaceBook Account An illustrated of white FaceBook Logo
  • BrowserStack LinkedIn Account An illustrated of white LinkedIn Logo
  • BrowserStack Youtube Channel An illustrated of white youtube Logo
  • BrowserStack Instagram Account An illustrated of white instagram Logo
BrowserStack Contact Us Icon An illustration of white contact us icon Contact Us

© 2011-2023 BrowserStack - The Most Reliable Mobile App & Cross Browser Testing Company

  • Terms of Service
  • Privacy Policy
  • Cookie Policy
  • Sitemap