October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk4 min

How to Set a Custom Mobile Viewport Size in Playwright

Set exact viewport width and height in Playwright Test or the library, override a device preset, and distinguish page dimensions from mobile emulation.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Set viewport to a pixel-width and pixel-height object. In Playwright Test, put it in the project’s use options or call test.use() for a test or group; with the Playwright library, set it when creating a browser context or call page.setViewportSize() before navigation. A viewport sets page dimensions, but it does not by itself emulate every mobile-device behavior.

Set a custom viewport for a Playwright Test project

In playwright.config.ts, configure use.viewport. Width and height are pixel dimensions of the page viewport.

As an Amazon Associate I earn from qualifying purchases.

import { defineConfig } from '@playwright/test';

export default defineConfig({
  use: {
    viewport: { width: 390, height: 844 },
  },
});

This applies to tests in the project unless a narrower configuration overrides it. See the Playwright emulation guide for viewport and device configuration.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Override a device preset’s viewport

A device preset supplies a collection of emulation settings. Spread the preset first, then set viewport afterward to override its viewport dimensions:

#1 Best Overall
EUCOS 62" Phone Tripod, Tripod for iPhone & Selfie Stick with Remote
  • 100% LIFETIME PROTECTION: Enjoy reliable performance with lifetime coverage, guaranteeing your tripod is always protected against any defects or issues.
  • Ultimate Materials & Engineerin: EUCOS's phone tripod utilizes modified Nylon PA6/6 for all-weather durability. The engineered polymer delivers exceptional crush/shear resistance and toughness, achieving optimal rigidity-flexibility balance.
  • Rapid Extension Tripod for Phone: Glide the rod in a single, fluid motion to convert it from a compact tripod into a full 62" selfie stick. Achieve instant elevation for dynamic filming.
  • Studio-Grade Phone Rig: Safely harness phones from 2.2" to 3.6" wide with pro-level clamping and effortless framing. Built-in cold shoe expands your creative options with lights and mics.
  • Hands-Free Control: The Wireless remote enables instant pairing with smartphone and remote capture from up to 33ft/10m. Ensures rock-solid stability for blur-free photography and Start/Stop video recordings effortlessly—all without device contact.
import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
  projects: [{
    name: 'mobile custom viewport',
    use: {
      ...devices['iPhone 13'],
      viewport: { width: 390, height: 844 },
    },
  }],
});

Keep the preset when you need its other device characteristics as well as custom page dimensions. The custom width and height alone do not establish a complete device profile.

Scope the viewport to a test or group

Use test.use() when only selected tests need the dimensions. At the top level of a test file it applies to that file’s tests; inside test.describe(), it scopes the option to that group.

Rank #2
Sale
SENSYNE 62" Phone Tripod, Extendable Selfie Stick with Wireless Remote
  • 62" Phone Tripod & Selfie Stick Combo: Extendable phone tripod for iPhone and Android, combining a tripod stand and selfie stick in one lightweight design for selfies, photos, videos, vlogging, live streaming, and family gatherings.
  • Adjustable Height & 360° Rotation: The tripod extends up to 62 inches to support standing shots, group photos, video calls, and content creation. The 360° rotating phone holder allows vertical or horizontal shooting.
  • Stable Phone Holder for Daily Recording: Designed for hands-free video recording, online meetings, tutorials, livestreams, and social content. The phone holder keeps your device positioned securely for clear, steady shots.
  • Wide Compatibility with Phones and Cameras: Fits most smartphones from 2.8" to 5.7" wide and includes a universal 1/4" screw mount for compatible cameras, action cameras, webcams, and camcorders.
  • Wireless Remote & Complete Kit: Includes 1 phone tripod/selfie stick, 1 universal phone holder, 1 adapter, and 1 wireless remote shutter. Backed by 12-month after-sales support for everyday shooting needs.
import { test } from '@playwright/test';

test.use({ viewport: { width: 390, height: 844 } });

test('mobile layout', async ({ page }) => {
  await page.goto('https://example.com');
  // Assert the layout at the configured viewport.
});

For a group, place the same test.use() call inside the describe block:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
test.describe('mobile layout', () => {
  test.use({ viewport: { width: 390, height: 844 } });

  test('renders at the group viewport', async ({ page }) => {
    await page.goto('https://example.com');
  });
});

Set or change the viewport with the Playwright library

Set it when creating the browser context

Context configuration is useful when you create pages through a context and want its viewport set from the start:

Rank #3
Victiv Tripod, 74” Camera Tripod for Cell Phone with Phone Holder, Orange
  • 【74 Inch Tall Tripod and Compact Tripod】 This tall camera tripod has a height adjustment range of 19-74 inches. It can meet the needs of daily work. This compact tripod comes with a carrying bag for outdoor and indoor shooting. This compact tripod weighs 3.14 lbs / 1.4 kg and is easy to store and stow.
  • 【Tripod for All Camera and Phone】Standard 1/4" screw mount and 3/8" screw compatible with all cameras ( Canon, Nikon, Fujifilm, Olympus, Panasonic), DSLR, SLR, and digital cinema cameras, also spotting scopes, projector, compact camcorders, binoculars. The 360° phone mount is compatible with iPhone 17 16 15 14 13 12 11 Pro/XS/XR/MAX/8/8 Plus/X/7 Plus/7/6s Plus/6s/6 Plus/6/Samsung Galaxy S22/ S21 Series/ Galaxy Z Flip/ NOTE/ One Plus 1+Series.
  • 【Professional 3-Way Pan Head】VICTIV Professional camera tripod stand is equipped with a stable and smooth 3-way pan head, it allows 360° horizontal panoramic shots, 180° up and down shots, and 90° vertical portraits. Non-slip pads provide great grip. You can also hang a backpack on the weight hook for extra stability.
  • 【Video Tripod for Photography】The video camera tripod is suitable for outdoor and indoor shooting. It can meet the daily shooting needs of video producers, video bloggers, and youtube users. Camera tripods for Photography, food shooting, live streaming, scenery shooting, and portrait shooting, etc.
  • 【Complete Tripod Units】What You Get: 1X Tripod for cell phone and camera, 1X Universal Phone Holder, 1X Extra Quick Release Plate,1X 3-way Pan Head, 1X Handle, 3X Non-slip pads. Please contact us anytime if any questions.
const context = await browser.newContext({
  viewport: { width: 390, height: 844 },
});
const page = await context.newPage();
await page.goto('https://example.com');

Resize an existing page

For a page created through the library, use page.setViewportSize(). Set the size before navigating when possible, especially for sites that do not expect a phone-sized page to change size after load.

const page = await browser.newPage();
await page.setViewportSize({ width: 390, height: 844 });
await page.goto('https://example.com');

The Page API reference notes that page.setViewportSize() also resets the screen size. If the emulated screen should have dimensions distinct from the viewport, configure both screen and viewport on the context instead.

Rank #4
Sale
Liphisy 64” Tripod for Cell Phone & Camera with Remote and Phone Holder | Sturdy & Stable Height Adjustable Multi-Angle Shot Selfie Stick Tripod for Video Recording
  • 【Sturdy and Stable】: Made of premium aluminum alloy and stainless steel, Liphisy phone tripod with remote keeps your device stay securely in place for still shots and video recording.
  • 【Multi-angle Shot】: With a max height of 64”, this tripod stand with a 210-degree rotation head and 360-degree rotation holder allows you to capture shots from any angle, catering to different photography needs.
  • 【Wireless Remote Included】: Package includes a wireless remote that connects to your cell phone easily, making it a breeze to snap photos or video recordings.
  • 【Height Adjustable】: The height of this cell phone tripod with remote can be adjusted from 17” to 64” and the easy lock mechanism makes it really easy to set up. It gives you an excellent vantage point for capturing photos and videos.
  • 【Wide Application】: Compatable with different phone and camera, this tripod is great for photography and video recording, perfect for travel and home use.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Choose viewport dimensions or full mobile emulation

Use a custom viewport when the question is whether a page layout works at a particular width and height. Use a device preset or additional context options when the test depends on device properties or behaviors beyond the page dimensions.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Page dimensions: viewport specifies width and height in pixels.
  • Mobile behavior: Options such as isMobile, touch behavior, and a mobile user agent can matter to sites that branch on device characteristics.
  • Screen versus viewport: Configure screen separately when it needs to represent dimensions different from the page viewport.
  • Engine support: Check support for each emulation option on the browser engine you run. Playwright documents isMobile as unsupported in Firefox; see the BrowserType API reference.

Playwright’s emulation documentation describes device presets as collections of parameters, rather than merely viewport shortcuts. A viewport override can therefore coexist with the preset’s other settings.

Best Value
Sale
VIMOSE 66" Phone Tripod, Tripod for iPhone with Remote & Phone Stand
  • Steel-Reinforced Steadiness:Featuring a tri-functional design, this 66-inch aluminum phone tripod stand integrates a steady base, telescoping arm, and multi-angle phone holder - an all-in-one solution for content creation, from overhead product shots to full-body portraits
  • Intuitive Angle Control: Precision-engineered locking flanges enable instant switching between portrait, landscape, and 45° angled shots. Universally compatible with mobile phones ranging from 2.2" to 3.6" widths without slippage, making it a versatile addition to your Tripod & Monopod Accessories
  • True Mobile Rig Flexibility:Engineered for steady everyday use rigidity, this adaptable cell phone tripod mount ensures rock-solid grip on smartphones. Its built-in Cold-Shoe slot enables seamless attachment of vlogging accessories like LED panels or mics
  • Vibration-Free Content Creation: Integrated wireless Bluetooth remote (10m range) eliminates touchscreen interference. Perfect for capturing crisp stills or initiating smooth video recordings hands-free – an essential tool among modern Tripod & Monopod Accessories for solo creators
  • In the Box: 66" Metal iphone tripod stand, 360° rotatable phone mount, 10m range phone camera remote, Includes 36 months of technical support and product coverage

Generate a test at a chosen viewport

Playwright’s code generator accepts --viewport-size. For example, this starts codegen at 800 by 600 pixels:

npx playwright codegen --viewport-size="800,600" https://example.com

To record while emulating a named device, use its --device option. The test generator documentation describes both options.

Troubleshoot viewport configuration

  • The preset dimensions keep appearing: Put viewport after ...devices['iPhone 13'] in the same use object so the custom value overrides the preset.
  • Only one test needs the dimensions: Use test.use() at file scope or inside the relevant test.describe(), rather than changing every project’s configuration.
  • The page changes after it has loaded: Set the viewport in context options or call page.setViewportSize() before navigation. Some sites do not expect phone-size changes after load.
  • The viewport and emulated screen should differ: Configure both screen and viewport on the context; resizing through page.setViewportSize() resets screen size.
  • A mobile-only behavior does not appear: A viewport changes page dimensions, not every device property. Add the required emulation options or use a device preset, and confirm that the browser engine supports those options.

Or skip the browser setup

If the goal is to obtain a website screenshot rather than run a Playwright test, ScreenshotNeo is a screenshot API with any-viewport support. A one-call request looks like this; see the API documentation for the supported request options.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

ScreenshotNeo accepts cookie and consent banners and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; each step can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, and responses identify the page verdict and billing status in headers. Its MCP server provides screenshot and page-information tools for AI agents. The free plan includes 1,000 shots per month with no card; paid plans start at $5 for 3,000 shots.

Sign up for 1,000 free screenshots a month, with no card required.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.