Skip to main content
Transform your testing process with: Real Device Features, Company-wide Licences, & Accessibility Testing
No Result Found
Get your setup working faster. Join our Discord for optimisation tips from elite testers. Join our DiscordJoin our Discord

Debug WebViews with WebView Inspector

Inspect and debug WebView elements in your mobile apps using the WebView Inspector in App Live.

The WebView Inspector feature is available under the Pro plan. You can also access the feature if you are in the Pro trial period. For more details check out our pricing page.

Using WebView Inspector, you can inspect HTML DOM elements, debug JavaScript, view console logs, and analyze WebView-specific network traffic of WebView elements in your mobile apps directly within App Live. The inspector displays WebViews that are available on the current app page, allowing you to focus on debugging active content.

The WebView Inspector is available in the DevTools toolbar on the testing dashboard.

WebView Inspector can only inspect WebViews that your app has enabled for remote debugging. To enable it, implement the platform-specific requirements in the app’s code:

BrowserStack can’t enable remote debugging on your behalf. Debug and QA builds usually enable remote debugging, but production and app store builds usually don’t.

Supported platforms

The following platforms support WebView Inspector:

Platform Supported versions
Android V13 and later
iOS V16 and later

Access WebView Inspector

To inspect and debug WebView elements in your app, use the WebView Inspector in the DevTools section of the testing dashboard:

  1. Log in to the App Live dashboard.
  2. Upload or install your app, then select a device from the list to launch your test session. For more details on app sources, see Get started.
  3. On the DevTools pane, click the WebView Inspector icon in the DevTools toolbar. The WebView Inspector pane opens and displays the WebViews available on the current app page.
    If the page contains no WebViews, or if the WebView is unavailable or expired, the pane shows a WebView data not found error.
    The highlighted WebView Inspector icon in the DevTools toolbar and the WebView Inspector pane displaying a sample WebView.

Switch between WebViews

If your app uses multiple WebViews on a page, you can switch between them:

  1. In the WebView Inspector pane, click the dropdown menu at the top. The dropdown displays all available WebView contexts on the current page.
    The WebView context dropdown menu in the WebView Inspector pane with multiple contexts listed.
  2. Select the WebView context you want to inspect from the list. The inspector updates to show the selected context.

Troubleshooting

Expand the following to resolve common WebView Inspector issues.

If WebView Inspector is active but lists no WebViews while your app is on a WebView screen, or shows WebView data not found, remote debugging probably isn’t enabled for those WebViews. To confirm and fix this, do the following:

  • On a physical device, install the same build you uploaded to App Live, then open it in Chrome’s chrome://inspect on Android or the Safari Develop menu on iOS. If no WebViews are listed there, remote debugging isn’t enabled in that build.
  • Upload a build with remote debugging enabled. Android builds must call WebView.setWebContentsDebuggingEnabled(true), and iOS 16.4 and later builds must set WKWebView.isInspectable = true. Production and app store builds usually omit these requirements, so upload a debug or QA build instead.
  • Rule out emulator-only builds. Some vendors enable WebView debugging for the Android Emulator only, so those builds don’t expose WebViews for inspection on the physical devices that App Live uses.
  • If you don’t control the app’s source, ask the vendor for a build with remote debugging enabled.

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





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 for immediate help while we work on improving our docs.

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





Thank you for your valuable feedback!

Talk to an Expert
Download Copy Check Circle