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

Puppeteer Screenshot with a Fixed Viewport Size

Use Puppeteer’s setViewport() before goto() to control page layout dimensions. Learn how screenshot scope, device scale, and common defaults affect the result.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Set the viewport with page.setViewport() before navigating, then capture the page with page.screenshot(). This fixes the browser page’s layout dimensions; by default, the screenshot shows only the visible viewport, not the whole document.

Set the viewport before navigation

In Puppeteer 25.12.0, pass explicit width and height values to page.setViewport(). Add deviceScaleFactor when the output’s pixel density matters. Set the viewport before page.goto(): sites can react to viewport changes, and certain mobile or touch settings may cause a reload. See the Page.setViewport() API reference.

As an Amazon Associate I earn from qualifying purchases.

const page = await browser.newPage();
await page.setViewport({
  width: 1280,
  height: 800,
  deviceScaleFactor: 1,
});
await page.goto('https://example.com');
await page.screenshot({ path: 'page.png' });

Replace the dimensions with the viewport you need to reproduce or test. There is no universally correct size: select values that match the target browser layout or responsive test case. With a device scale factor of 1, the configured CSS viewport dimensions are not multiplied for a higher-density capture.

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

Choose what the screenshot should include

The viewport size controls the page’s content area for layout and rendering; it does not by itself mean “capture the entire page.” Puppeteer’s default screenshot is viewport-only. Use fullPage: true for the whole page, or clip to capture a region.

#1 Best Overall
71 Inch Camera Tripod, 2‑in‑1 Selfie Stick Tripod Stand for Camera & Phone
  • 【1.3lb Ultra-Lightweight & 16” Compact Portable】 Crafted from premium aluminum alloy, this tripod balances sturdiness and portability perfectly. Weighing only 1.3lb (0.59kg) with a 16” folded size, it slips easily into your backpack/luggage—ideal for travel, hiking, camping, or on-the-go shooting. The solid triangular frame + non-slip rubber feet ensure stable support for smartphones and small cameras (NOTE: Not suitable for heavy cameras; max
  • 【3-Way Pan Head with 360° Rotation & Bubble Level】 Equipped with a smooth 3-way pan head, support 360° panoramic shots, 180° tilting, and 90° vertical portrait mode. Whether capturing landscapes, portraits, or vlogs, you can adjust angles freely for stunning compositions. Built-in bubble level helps you align horizons accurately—no more slanted photos/videos.
  • 【2-in-1 Tripod & Selfie Stick (16” to 71” Adjustable)】 Upgraded dual-function design: switch between stable tripod and handheld selfie stick in seconds. Telescopes from 16” to 71” (40cm to 180cm) to fit different shooting heights—from low-angle macro shots to tall group photos. Remains stable at any height, keeping your device secure even in outdoor or uneven terrain.
  • 【Wide Compatibility + Cold Shoe Port for Accessories】 Standard 1/4” screw fits most cameras, ring lights, projectors, laser levels, and webcams. The included adjustable phone holder (2.3”–3.9” width) works with most smartphones (including iPhone 16 Pro Max/Samsung Galaxy S24 Ultra). Built-in cold shoe port supports fill lights or microphones—perfect for content creators, vloggers, and live streamers.
  • 【Complete Accessories + 33ft Wireless Remote】 Package includes: 1×Tripod, 1×Universal Phone Holder, 1×Wireless Remote, 1×Carry Bag, 1×Instruction Manual. The Bluetooth remote works with all iOS/Android phones within 33ft (10m)—enables hands-free shooting for selfies, group photos, or time-lapses. TIP: Rotate the selfie stick to the right to lock it before use (prevents loose positioning).
Capture scope Option What it captures
Visible viewport Default, or fullPage: false The visible page area at the configured viewport size.
Full page fullPage: true The whole page, including content beyond the visible viewport.
Specific region clip The rectangle specified for the screenshot.

For example, to save the full page rather than the visible portion:

await page.screenshot({ path: 'page.png', fullPage: true });

For option defaults and behavior, consult Puppeteer’s ScreenshotOptions reference and Screenshots guide.

Rank #2
ULANZI MT-44 Auto Open Phone Tripod, 59" Extendable Selfie Stick Vlog Stand
  • 【Universal Phone & Camera Tripod with 2 in 1 Integrated Design】Featuring in upgraded and integrated design, MT-44 tripod expands itself in the usage of other smart devices other than phone. The adjustable clip on the top can be expanded to universal phone clip to 60-80 mm which is compatible with most of smart phone, and can be gathered to storage camera through the 1/4" screw thread(NOTE:NOT INCLUDES REMOTE CONTROL)
  • 【360° Panoramic Ballhead for Horizontal & Vertical Shooting】Designed with 360 rotatable degree universal ballhead, our phone & camera tripod can adjust various angles for shooting, allowing you to capture the perfect shot. Tighten the knob adjustment on the ball head, and you can lock to a certain fixed angle
  • ▶【Telescopic Design】The 7-section ABS-made tripod enables fast and fumble-free set-up, making it to easy extend from 13"/340mm to 59"/1500mm which is longer than similar tripod on the market. Just rotate the lock knob and extend at a certain height where you want to meet your different shooting needs(Note:Max extended height: 57.8'', reaches 59'' with phone holder attached.)
  • ▶【Cold Shoe & 1/4" Screw Thread for Rich Expansion】Based on diversified needs, we have specially designed cold shoe and 1/4" screw thread which is convenient for external photographic camera auxiliary equipment. Cold shoe on the top of clip allows you to mount a microphone or led video light for selfie Vlog. The 1/4" screw allows you to mount a phone holder, camera or other device
  • ▶【Wide Compatibility】The extendable tripod can works as handle grip or selfie stick, mini and lightweight. Benefiting by the adjustable holder and standard adapter 1/4" screw thread, the vlog ​tripod is fully compatible with DSLR Camera Nikon Canon G7 Fujifilm Sony RX Panasonic Nikon D610, the photography tripods also works well with Osmo Pocket3, Osmo 360, insta360 X5, iPhone17/17 Air/ 16 15 14 13 12/12Pro/12Pro Max/11/11Pro/11Pro Max/X/Xs/XR/Xs Max,8/7/6/6s, iPhone 6/6s plus, iphone SE, Samsung, Huawei

Use other screenshot options when needed

  • path saves the image to a file; Puppeteer infers the image type from the extension. PNG is the default type.
  • type selects an image format. quality applies to supported lossy formats, not PNG.
  • omitBackground: true omits the default white background, allowing transparency.
  • captureBeyondViewport defaults to false when no clip is specified. When a clip is specified, its default is true.

To capture a particular element instead of a page region, use ElementHandle.screenshot(). Puppeteer’s guide notes that it attempts to scroll the element into view if it is hidden.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

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

Understand viewport size versus screen size

A page viewport is the content area used to lay out and render that page. It is distinct from the headless browser screen configuration. The Puppeteer screen-configuration guide documents an 800 × 600 default headless screen unless a window-size switch is specified; most page screenshot tasks only need an explicit page viewport. See Screen configuration.

Rank #3
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.

Puppeteer’s connection default viewport is also documented as 800 × 600. page.viewport() returns the last viewport configured with page.setViewport(), or the default from connection options; it does not inspect the page’s actual viewport. Treat it as the configured value, not an independent verification of rendered dimensions. See ConnectOptions and Page.viewport().

Troubleshoot unexpected output

The image only shows the top or visible part of the page

This is the default behavior. Add fullPage: true if you need content below the fold. Keep the default when the goal is to compare a fixed viewport or test responsive layout.

Rank #4
Sale
Amazon Basics 50-inch Lightweight Portable Camera Tripod Stand with Quick-Release Plate, Adjustable Height, Aluminum, for Travel Photography, Champagne
  • Camera mount tripod stand with zippered storage bag
  • Adjustable height from 16.1inch to 50inch with 3-section,lever-lock legs for simple adjustments
  • Folds down quickly and made of lightweight aluminum; It weighs only 1.23 lbs,lightweight and portable, easy to carry for travel,hiking,camping,etc
  • 3-way head allows for tilt and swivel motion;portrait or landscape options;Built in Bubble Level,fast and accurate positioning
  • Quick-release plate helps ensure fast transitions between shots

The page layout does not match the intended dimensions

Set width and height explicitly before navigation. If you change viewport settings after loading, the site may respond to the change; some mobile or touch configurations may reload it. Choose a viewport matching the layout you are testing rather than assuming one size fits all.

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

The saved file is not the format you expected

Check the filename extension and any explicit type option. The file path extension determines the inferred image type, and PNG is the default.

Best Value
VICTIV 74” Camera Tripod, Tripod for Camera and Phone with Phone Holder
  • 【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 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

page.viewport() reports the expected size, but the render still differs

The method reports Puppeteer’s configured viewport and does not check the page’s actual viewport. Also distinguish the page viewport from headless screen configuration; changing the latter is not necessary for most screenshot tasks.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

For a one-request screenshot without managing Puppeteer, use ScreenshotNeo, a screenshot API and MCP server. Its API accepts a URL and can return an image or PDF. For example, this cURL request saves a WebP capture:

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://example.com -o shot.webp

See the ScreenshotNeo documentation for API parameters. ScreenshotNeo removes cookie banners, newsletter popups, and chat widgets before the shot; bot checks, blank pages, and failed loads are never billed. Its MCP server lets AI agents take screenshots. The free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000. Sign up for free.

Free tools Windows power users keep installed

One-click scans. No signup required.

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

Frequently Asked Questions

Does setting a viewport automatically capture the full page?

No. The default screenshot captures the visible viewport; use fullPage: true for the whole document.

Should I set the viewport before or after navigating?

Before navigation, so the page loads with the intended dimensions and avoids possible layout changes after loading.

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
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

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.