Develop

Debug Browser content

Updated: Jul 22, 2026

Overview

Use Chrome DevTools on your computer to inspect a site that is open in Meta Quest Browser. This workflow applies to hosted 2D content, screen-based 3D sites, and WebXR experiences tested on a headset.

Prerequisites

Enable Developer Mode and complete the USB setup in Device setup.
Install Android Platform Tools so the adb command is available.
Connect the headset to your computer with USB.

Verify the ADB connection

Run:

adb devices

The headset should appear in the output with the status device. If it does not appear, check the USB connection and the device setup requirements.

Open a local development server

If your site runs on a local port, use adb reverse to make that port available to Browser. The following example maps port 8080 on the headset to port 8080 on the computer:

adb reverse tcp:8080 tcp:8080

Replace 8080 with the port used by your development server.

After mapping the port, open localhost:8080 in Browser. Replace 8080 with the mapped port and use the scheme required by your development server.

Inspect a browser tab

Open the site in Meta Quest Browser.
Open Google Chrome on your computer and go to chrome://inspect/#devices.
Find the headset and the Browser tab you want to debug.
Select inspect to open Chrome DevTools for that tab.

See Remote debug Android devices⁠ in the Chrome DevTools documentation for more information.

Test IWSDK projects on desktop

IWSDK includes IWER for WebXR emulation in a desktop browser. Follow Test an IWSDK experience to use IWER and to test the same project on a physical headset.

You can also use Meta Quest Developer Hub to connect and manage a development device.