For AI agents: a documentation index is available at /llms.txt
Skip to main content

Supported mobile devices

These are the Android phones, iPhones, and iPads you can select with the emulatedDevice query parameter when running a stealth or BQL session with emulationOs=android or emulationOs=ios. Each slug maps to a real phone or tablet, and picking one makes the session report that device's screen size, pixel ratio, and hardware identity coherently.

Prerequisites

Pass the slug exactly as listed — values are case-sensitive and matched exactly (pixel-8, not Pixel-8 or pixel8). Omit emulatedDevice entirely and Browserless picks a device for you and keeps it stable for the session. An unrecognized slug is not an error; it falls back to an automatically chosen device.

wss://production-sfo.browserless.io/stealth?token=YOUR_API_TOKEN_HERE&emulationOs=android&emulatedDevice=pixel-8-pro

Devices​

Android devices​

SlugDeviceScreen (CSS px)Pixel ratio
pixel-8Google Pixel 8412 × 9152.625
pixel-8-proGoogle Pixel 8 Pro448 × 9983
galaxy-s23Samsung Galaxy S23360 × 7803
galaxy-s23-ultraSamsung Galaxy S23 Ultra384 × 8243.75
galaxy-s24Samsung Galaxy S24360 × 7803
galaxy-s24-plusSamsung Galaxy S24+384 × 8323.75
galaxy-s24-ultraSamsung Galaxy S24 Ultra384 × 8323.75
galaxy-s25Samsung Galaxy S25360 × 7803
galaxy-s25-plusSamsung Galaxy S25+412 × 8913.5
galaxy-s25-ultraSamsung Galaxy S25 Ultra412 × 8913.5
galaxy-s26Samsung Galaxy S26360 × 7803
galaxy-s26-plusSamsung Galaxy S26+412 × 8913.5
galaxy-s26-ultraSamsung Galaxy S26 Ultra412 × 8913.5
pixel-9Google Pixel 9412 × 9152.625
pixel-9-proGoogle Pixel 9 Pro427 × 9523
pixel-9-pro-xlGoogle Pixel 9 Pro XL448 × 9973

Android emulation uses Chrome's frozen Android User-Agent, so the exact model isn't in the User-Agent string. The device is conveyed through UA Client Hints instead. Every device reports portrait orientation and five touch points.

iPhone devices​

These slugs need emulationOs=ios. With no emulatedDevice, Browserless picks from this list, which is the default deviceType=phone pool.

SlugDeviceScreen (CSS px)Pixel ratio
iphone-15Apple iPhone 15393 × 8523
iphone-16Apple iPhone 16393 × 8523
iphone-16-proApple iPhone 16 Pro402 × 8743
iphone-16-pro-maxApple iPhone 16 Pro Max440 × 9563
iphone-17Apple iPhone 17402 × 8743
iphone-17-proApple iPhone 17 Pro402 × 8743
iphone-17-pro-maxApple iPhone 17 Pro Max440 × 9563
iphone-17eApple iPhone 17e390 × 8443
iphone-18-proApple iPhone 18 Pro402 × 8743
iphone-18-pro-maxApple iPhone 18 Pro Max440 × 9563

iPad devices​

These slugs need emulationOs=ios. Add deviceType=tablet and omit the slug to have Browserless pick one of these iPads for you.

SlugDeviceScreen (CSS px)Pixel ratio
ipad-10Apple iPad 10820 × 11802
ipad-air-13Apple iPad Air 131024 × 13662
ipad-pro-11Apple iPad Pro 11834 × 12102
ipad-pro-13Apple iPad Pro 131032 × 13762
ipad-miniApple iPad mini (A17 Pro)744 × 11332
ipad-air-11Apple iPad Air 11 (M4)820 × 11802
ipad-a16Apple iPad (A16)820 × 11802
wss://production-sfo.browserless.io/stealth?token=YOUR_API_TOKEN_HERE&emulationOs=ios&emulatedDevice=ipad-pro-11

Like every iOS browser, iOS emulation sends no UA Client Hints. The User-Agent names the device class, iPhone or iPad, rather than the model. Every iPhone and iPad reports four CPU cores, five touch points, and portrait orientation.

FAQ & Troubleshooting​

My emulatedDevice value returned a 400 error

emulatedDevice needs emulationOs=android or emulationOs=ios on a stealth route, a BQL route, or the Agent route (/chromium/agent). Sending it on its own returns emulatedDevice requires emulationOs=android or ios on a stealth request (a /stealth/*, BQL, or /chromium/agent route). Add emulationOs=android for a Pixel or Galaxy slug, or emulationOs=ios for an iPhone or iPad slug.

I passed a device slug but the session reports a different phone

Slugs are case-sensitive and matched exactly. A typo, wrong casing, or a slug not in the table above is silently ignored, and Browserless picks a device automatically. Copy the slug verbatim from the table.

Can I emulate a device that isn't listed?

No. There's no way to supply a custom device profile, and a slug that isn't in the tables falls back to an automatically chosen device. Pick one of the Android phones, iPhones, or iPads listed above, choosing the closest screen size if none matches exactly.

Which slug gives me a tablet?

Any ipad-* slug, with emulationOs=ios. To let Browserless pick an iPad for you, send emulationOs=ios&deviceType=tablet without emulatedDevice. Sending an iPad slug with deviceType=phone returns an HTTP 400 with the message deviceType contradicts emulatedDevice.

Next steps​

Was this page helpful?