Browserstack logo
  • AI Agents
  • Pricing
  • Manual Testing

    Live

    Cross-browser testing

    Testing Toolkit

    Essential manual testing tools

    Accessibility Testing

    Test WCAG compliance

    Website Scanner

    All-in-one website checker

    Test Automation

    Automate

    Browser automation grid

    Low Code Automation

    Automation without coding

    Accessibility Automation

    Automate WCAG testing

    Percy

    Visual testing & review

    Automate TurboScale

    Automation on your Cloud

    Management & Optimization

    Test Management

    Unify & track all test cases

    Test Reporting & Analytics

    Monitor & optimize all tests

    Explore BrowserStack for Enterprise | Bug Capture | Requestly | Private Devices

    Manual Testing

    App Live

    Real device testing

    App Accessibility Testing

    Test WCAG compliance

    Test Automation

    App Automate

    Real device automation cloud

    App Percy

    Visual testing for mobile apps

    Management & Optimization

    Test Management

    Unify & track all test cases

    Test Reporting & Analytics

    Monitor & optimize all tests

    Explore BrowserStack for Enterprise | Bug Capture | Requestly | Private Devices

    • Documentation
    • Support
    • Status
    • Release Notes
    • Open Source
    • Events
    • Meetups
    • Champions
  • AI Agents
  • Pricing
  • Sign in
  • Free Trial
  • Manual Testing
  • Live
    Manual cross-browser testing
  • Accessibility Testing
    Super app to find & report issues
  • Test Automation
  • Automate
    Browser automation grid
  • Percy
    Visual testing & review
  • Management & Optimization
  • Test Management
    Unify & track all test cases
  • Test Reporting & Analytics
    Monitor & optimize all tests
  • For Teams
  • Enterprise
  • Manual Testing
  • App Live
    Manual real device testing
  • App Accessibility Testing
    Test WCAG compliance
  • Test Automation
  • App Automate
    Real device automation cloud
  • App Percy
    Visual testing for mobile apps
  • Management & Optimization
  • Test Management
    Unify & track all test cases
  • Test Reporting & Analytics
    Monitor & optimize all tests
  • For Teams
  • Enterprise
  • Documentation
  • Support
  • Status
  • Release Notes
  • Open Source
  • Events
  • Champions
  • 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.18.0 , 2.15.0 , 2.12.1 , 2.6.0 , 2.4.1 , 2.0.1 , 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.19.0 , 2.18.0 , 2.15.0 , 2.12.1 , 2.6.0 , 2.4.1 , 2.0.1 , 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
    • App Automate
    • App Live
    • Automate
    • Accessibility Testing
    • Low Code Automation
    • Percy
    • App Accessibility Testing
    • Accessibility Automation
    • Test Management
    • Test Reporting & Analytics
    • App Percy
    • Automate TurboScale
    • Bug Capture
    • Requestly
    • Website Scanner
    • Testing Toolkit

    WHY BROWSERSTACK

    • Customers
    • Case Studies
    • AI Agents
    • Browsers & Devices
    • Enterprise
    • Data Centers
    • Real Device Features
    • Security

    RESOURCES

    • Support
    • Status
    • Release Notes
    • Blog
    • Events
    • Community
    • Meetups
    • Champions
    • Guide
    • Partners
    • Find a partner
    • Trust Center
    • Test University (Beta)

    COMPANY

    • About Us
    • Careers
    • Open Source
    • Press
    • Newsletter
    Browserstack logo
    SOCIAL
    twitter social link facebook social link linkedin social link youtube social link instagram social link discord social link
    Contact Us

    We are available 24 / 7

    More Resources

    Cross Browser Testing Selenium Testing Test Management Emulators vs Real Device Mobile App Testing

    Test on Device

    Test on iPad Test on Galaxy Test In IE Test on Android Test on iOS Mobile Emulators Test on Right Devices

    Tools

    SpeedLab Screenshots Responsive Nightwatch.js
    discord social link
    Contact Us

    We are available 24 / 7

    © 2025 BrowserStack. All rights reserved.

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