--- source_url: "https://www.browserstack.com/docs/app-automate/appium/integrations/testim" title: "Integrate BrowserStack App Automate with Testim | BrowserStack Docs" mirrored_at: 2026-08-14T01:03:20.306Z host: www.browserstack.com cited_in_42a: true mirror_canonical: "https://index.42a.ai/www.browserstack.com/docs/app-automate/appium/integrations/testim" --- > **Original source:** https://www.browserstack.com/docs/app-automate/appium/integrations/testim Get your setup working faster. Join our Discord for optimisation tips from elite testers. ![Join our Discord](https://www.browserstack.com/docs/static/img/discord-cta-strip/Discord-Symbol-Blurple.svg)[Join our Discord](https://www.browserstack.com/discord?ref=docsArticle&source=docs_article_page) A step-by-step guide to running Testim mobile app tests with BrowserStack App Automate [Testim](https://www.testim.io/) is a platform that lets you record and playback automated tests in minutes. Testim helps you capture detailed step-by-step bug scenarios. It significantly reduces the maintenance and rewriting of tests. Testim supports mobile app testing through Appium integration, allowing you to test your mobile applications on BrowserStack’s real device cloud. ## Prerequisites Before you begin, ensure you have: - A Testim account with mobile app testing capabilities. - You have access to the BrowserStack account credentials, namely [Access Key and Username](https://www.browserstack.com/accounts/settings). - Your mobile application (APK for Android or IPA for iOS). ## Integration steps Follow the steps below to integrate Testim with BrowserStack App Automate: ### Upload your app to Testim 1. Navigate to the **Mobile Apps Library** in Testim. 2. Click **\+ NEW APP** button. 3. Upload your application file (APK or IPA). 4. Wait for the upload to complete. Your app will appear in the library with its version and details. ![The Mobile Apps Library showing an uploaded application](https://www.browserstack.com/docs/static/img/appium/integrations/testim/mobile-apps-library.webp) ### Add BrowserStack grid in Testim 1. Navigate to the **Grids** section in Testim. 2. Click **\+ ADD NEW GRID** button. 3. Enter a name for your grid (for example, “browserstack”). 4. In the **Host** field, enter `hub-cloud.browserstack.com`. 5. In the **Port** field, enter `443`. 6. Enter your BrowserStack **Username** and then **Access Key**. 7. Click **UPDATE** to save the grid configuration. ![The Grids page in Testim showing available grids](https://www.browserstack.com/docs/static/img/appium/integrations/testim/grids-page.webp) ![The Edit Grid dialog with BrowserStack configuration details](https://www.browserstack.com/docs/static/img/appium/integrations/testim/edit-grid-dialog.webp) ### Create a configuration for BrowserStack 1. In the Testim **Editor**, open your recorded test. 2. Click the dropdown icon next to the **Run** button. 3. Select **Run on a grid**. 4. Select your BrowserStack grid from the dropdown. 5. If no configuration exists, you’ll see an **untitled configuration** option. Click the edit button next to it. 6. In the **Create New Configuration** dialog: - Enter a **Configuration Name** - Choose **browserstack** as the grid - Select **Static allocation** as the configuration type - Choose your desired device from the available devices list (for example, Samsung Galaxy S23 Ultra with OS version 13.0) 7. Click **ADD** to save the configuration. ![The Run on a grid dropdown showing BrowserStack grid selection](https://www.browserstack.com/docs/static/img/appium/integrations/testim/run-on-grid.webp) ![The Create New Configuration dialog showing device selection options](https://www.browserstack.com/docs/static/img/appium/integrations/testim/create-configuration.webp) ### Run tests on BrowserStack 1. In the Testim **Editor**, open your test. 2. Click the dropdown icon next to the **Run** button. 3. Select **Run on a grid**. 4. Choose your BrowserStack grid from the dropdown. 5. Select the configuration you created. 6. Click **RUN** to execute the test. ![The Testim Editor showing a test ready to run on BrowserStack grid](https://www.browserstack.com/docs/static/img/appium/integrations/testim/wiki-app-test.webp) The test will run on BrowserStack App Automate, and you can monitor it in real-time on the [App Automate dashboard](https://app-automate.browserstack.com/dashboard). ## Configure capabilities for App Automate For optimal integration with BrowserStack, Testim requires capabilities to be formatted according to W3C WebDriver standards. BrowserStack-specific capabilities must be nested inside `bstack:options`. ### Capability format When running tests through Testim, capabilities are automatically configured. However, if you’re customizing capabilities through the Testim CLI with `--mode appium`, ensure the following format: **Standard Appium capabilities (at top level with `appium:` prefix):** - `appium:platformVersion` - `appium:deviceName` - `appium:app` Under the W3C WebDriver protocol, only `platformName` is a standard capability. Non-standard capabilities such as `deviceName`, `platformVersion`, and `app` must be prefixed with `appium:` when sent over the raw Appium protocol (as used by the Testim CLI with `--mode appium`). BrowserStack SDK examples may show these capabilities without the prefix because the SDK handles prefixing internally. For details, see the [Appium W3C capabilities reference](https://appium.io/docs/en/2.0/guides/caps/). **BrowserStack capabilities (inside `bstack:options`):** - `buildName` - `projectName` - `sessionName` - `realDevice` - `debug` - `networkLogs` For the full list of supported capabilities, refer to the [BrowserStack App Automate capabilities documentation](https://www.browserstack.com/docs/app-automate/capabilities). - Tests can only be recorded on a physical, or virtual devices provided by Testim. There is no option to select a remote grid for recording the script. - Testim sets the project name, build name, and other capabilities automatically with limited customization options. Your tests will appear on the App Automate dashboard with these automatically generated names. - For advanced configuration options, refer to the [Testim documentation on grid management](https://docs.tricentis.com/testim/content/integrations/grid-management/saucelabs-browserstack-options.htm). ## Next steps - [View test results on the App Automate dashboard](https://app-automate.browserstack.com/dashboard) - [Debug failed tests using App Automate features](https://www.browserstack.com/docs/app-automate/appium/view-logs-and-debug-tests) Did this page help you? #### We're sorry to hear that. Please share your feedback so we can do better Contact our [Support team](https://www.browserstack.com/support) 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 No #### We're sorry to hear that. Please share your feedback so we can do better Contact our [Support team](https://www.browserstack.com/support) 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!