Devices

Pass a device preset to emulate its user agent, viewport, and pixel ratio in one go. Add orientation: "landscape" to rotate. See the devices guide for examples.

{ "url": "https://example.com", "device": "iPhone 14 Pro", "orientation": "portrait" }

Custom presets

  • Mobile: iPhone 14 Pro, iPhone 14 Pro Max, Samsung Galaxy S23
  • Tablet: iPad Pro 12.9"
  • Desktop: Desktop 1080p, Desktop 1440p, Desktop 4K

Built-in devices

Common Puppeteer device names also work:

  • iPhone: iPhone SE, iPhone X, iPhone XR, iPhone 11–13 (incl. Pro / Pro Max / Mini)
  • iPad: iPad, iPad Air, iPad Mini, iPad Pro, iPad Pro 11
  • Android: Pixel 2–5 (incl. XL), Galaxy S5, Galaxy S8, Galaxy S9+, Galaxy S20 Ultra, Nexus 4–10
  • Laptop: Laptop with touch, Laptop with HiDPI screen, Laptop with MDPI screen

Custom dimensions

Or specify size inline as type-WIDTHxHEIGHT:

"device": "mobile-375x667"
"device": "tablet-768x1024"
"device": "desktop-1920x1080"

Prefer full control? Skip device and set a viewport directly.