Back to docs

Tool List Devices

Category: Browser Automation · Tier: Free · Since: v20.0.0

List the device presets that device parameters accept, with each one's size, pixel ratio and touch and mobile flags, plus the size-only viewport presets. Use it before navigate with device to pick a phone or tablet.

Parameters

Parameter Type Required Default Description
query string No - Only presets whose key or name contains this text, in any case, e.g. iphone, pixel, ipad
includeLandscape boolean No false Include the -landscape variants

Example

Which iPhone presets can I emulate?
→ list_devices query="iphone"

Response

Field What it holds
count How many device presets matched
devices One entry per preset: key, name, width, height, deviceScaleFactor, isMobile, hasTouch
viewportSizes The size-only presets: name, width, height
note How a device differs from a viewport size

One device entry:

{
  "key": "iphone-15",
  "name": "iPhone 15",
  "width": 393,
  "height": 852,
  "deviceScaleFactor": 3,
  "isMobile": true,
  "hasTouch": true
}

Devices and sizes

A device is full emulation: user agent, touch, pixel ratio and size. A viewport size sets the page size only. mobile, tablet and desktop are the same size in both lists.

Size name Size
mobile-sm 320x568
mobile 393x852
mobile-lg 414x896
mobile-xl 428x926
tablet-sm 768x1024
tablet 834x1194
tablet-lg 1024x1366
desktop-sm 1280x800
desktop-md 1440x900
desktop 1920x1080
desktop-lg 1920x1080
desktop-xl 2560x1440

Names match in any case and with spaces or hyphens: iPhone 15 and iphone-15 are the same preset. The device list includes Playwright's presets, so it grows with the installed Playwright version.

From the Blog