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
      Manual cross-browser testing
    • Automate
      Browser automation grid
    • Percy
      Visual testing & review
    • Accessibility Testing
      Super app to find & report issues
    • Test your mobile apps
    • App Live
      Manual real device testing
    • App Automate
      Real device automation grid
    • App Percy
      Visual testing for mobile apps
    • Test management & optimization
    • Test Management
      Unify & track all test cases
    • Test Observability
      Smart test reporting & debugging
    • Test development
    • Nightwatch.js
      End-to-End testing framework

    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
    Manual cross-browser testing
  • Automate
    Browser automation grid
  • Percy
    Visual testing & review
  • Accessibility Testing
    Super app to find & report issues
  • Test your mobile apps
  • App Live
    Manual real device testing
  • App Automate
    Real device automation grid
  • App Percy
    Visual testing for mobile apps
  • Test management & optimization
  • Test Management
    Unify & track all test cases
  • Test Observability
    Smart test reporting & debugging
  • Test development
  • Nightwatch.js
    End-to-End testing framework
  • 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.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.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 New
    • Test Management Beta
    • Test Observability Beta
    • Accessibility Testing Beta
    • Nightwatch
    • Enterprise

    Tools

    • SpeedLab
    • Screenshots
    • Responsive

    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

    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

    © 2023 BrowserStack. All rights reserved.

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