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

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

A blurry Puppeteer screenshot on a high-DPI screen does not, by itself, point to a Puppeteer bug. First compare the browser viewport in CSS pixels with the saved image’s actual pixel dimensions. Then verify the effective deviceScaleFactor, capture options, image format, and the Puppeteer and Chrome versions used to make the file.

1. Compare the viewport with the saved image dimensions

A viewport width and height describe CSS pixels; the screenshot file has raster dimensions measured in image pixels. They are related, but should not be assumed to match. Inspect the saved PNG’s width and height, then compare those values with the viewport you requested and the effective device scale factor. Puppeteer documents deviceScaleFactor as the device scale factor and gives it a default of 1 (Puppeteer Viewport interface).

If the image contains fewer pixels than you expected, check whether the scale factor was explicitly set and whether the output is being resized or displayed at a larger size elsewhere in your workflow. If the raster dimensions are adequate but edges still look soft, test the image format and any later resizing or display step before changing the viewport.

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

2. Make the viewport and scale factor explicit

Do not rely on an implicit default while diagnosing a high-DPI capture. Set the viewport before taking the screenshot, and record its width, height, and deviceScaleFactor. The value in your code is only useful if it is the value in effect for the page at capture time.

#1 Best Overall
Sale
Samsung 27" ViewFinity S7 (S71H) 4K UHD IPS HDR10 High Resolution Monitor
  • Samsung’s 27" ViewFinity S7 (S71H) 4K UHD Monitors provide exceptional clarity for professionals across all industries
  • 4K UHD (3840 x 2160 resolution) delivers visual excellence with high pixel density which reveals greater levels of detail and accurate color representation
  • More screen space enables the creation of intricate designs, complex diagrams, and dynamic video content
  • HDR10 optimizes contrast, offering a gamut of more than 1 billion accurate colors with darker blacks and brighter highlights
  • Features HDMI and DP ports for a convenient interface that simplifies setup and enhances productivity
await page.setViewport({
  width: 1280,
  height: 800,
  deviceScaleFactor: 2,
});

await page.screenshot({ path: 'capture.png' });

This is a minimal diagnostic example, not a guarantee that every capture will have a particular raster size: capture geometry and browser behavior can also matter. Check the dimensions of the resulting file rather than inferring them from the viewport alone. See Puppeteer’s screenshots guide and Page.screenshot() reference.

3. Check what region and options the screenshot captures

Record the options passed to Page.screenshot(), especially fullPage, clip, and captureBeyondViewport. They affect the captured region and can affect resulting dimensions, so compare like-for-like captures before attributing a difference to high-DPI rendering. The full option reference is the Puppeteer ScreenshotOptions interface.

Rank #2
Sale
Dell 32 Monitor S3225QS, 4K UHD VA, 120Hz, FreeSync Premium, Eye Comfort
  • Improved ComfortView Plus: Reduces harmful blue light emissions to ≤35%, for all-day comfort without sacrificing color accuracy.
  • Refresh rate: A smooth, tear-free experience with AMD FreeSync Premium (refresh rate up to 120Hz) and an ultra-low 0.03ms response time create a captivating experience for work and play.
  • Vivid colors: Immerse yourself in 4K visuals with a VA panel. Enjoy true-to-life colors with 99% sRGB and 95% DCI-P3 coverage. The 1500:1 contrast ratio and HDR readiness deliver excellent depth and detail.
  • Re-engineered sound quality: Enjoy more detailed sound with spacious audio featuring greater output power, deeper frequency response and more decibel range than the previous generation.
  • Ultra-thin bezel: Designed with a sleek, modern aesthetic and an ash white finish, this display features ultra-thin bezels for a refined, minimalist design.
  • fullPage: note whether the capture includes the full page or only the visible viewport.
  • clip: record the clip rectangle and its dimensions if you use one.
  • captureBeyondViewport: record whether it is enabled; do not assume its interaction with scaling without checking the output.

4. Separate resolution from image encoding

Save a PNG as a baseline and inspect its dimensions. Then, if your production output is JPEG and appears soft, compare the same capture as PNG and JPEG. Puppeteer’s screenshot quality option does not apply to PNG; it is relevant when using a supported lossy format. A format comparison can help isolate compression softness from insufficient raster resolution (ScreenshotOptions interface).

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

Also check whether an image-processing step, web page, or image viewer resizes the file after capture. A screenshot with adequate source dimensions can still look blurred when scaled to fit a display area.

Rank #3
Sale
Dell 27 Monitor S2725QS, 4K UHD IPS, 120Hz, 5ms, FreeSync Premium
  • Improved ComfortView Plus: Reduces harmful blue light emissions to ≤35%, for all-day comfort without sacrificing color accuracy.
  • Refresh rate: A smooth, tear-free experience with AMD FreeSync Premium (refresh rate up to 120Hz) and an ultra-low 0.03ms response time create a captivating experience for work and play.
  • Vivid colors: Immerse yourself in breathtaking 4K visuals with in-plane switching technology. Enjoy vibrant colors with 99% sRGB. The 1500:1 contrast ratio and HDR readiness deliver excellent depth and detail.
  • Re-engineered sound quality: Enjoy more detailed sound with spacious audio featuring greater output power, deeper frequency response and more decibel range than the previous generation.
  • Ultra-thin bezel: Designed with a sleek, modern aesthetic and an ash white finish, this display features ultra-thin bezels for a refined, minimalist design.

5. Reduce the issue to a reproducible capture

  1. Record the installed Puppeteer package version and the Chrome or Chromium version it launches.
  2. Use one page and one URL. Set the viewport explicitly, including deviceScaleFactor.
  3. Make one Page.screenshot() call, saving a PNG without unrelated processing.
  4. Record the screenshot options, including whether fullPage, clip, or captureBeyondViewport is used.
  5. Inspect and report the output image’s width and height in pixels.
  6. If PNG is sharp but JPEG is soft, investigate encoding settings. If both look soft despite adequate dimensions, check how the image is being resized or displayed.

This gives you a useful basis for diagnosing the particular setup. A report about a specific issue involving captureBeyondViewport and deviceScaleFactor exists in Puppeteer issue #11514, but that report is not evidence of a general defect in current Puppeteer. Include your exact versions, options, and output dimensions when raising a bug.

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

Or skip the browser setup

If you need a screenshot rather than a Puppeteer-specific reproduction, ScreenshotNeo can return an image or PDF from one GET request. For a WebP capture, use:

Best Value
Sale
LG 27UP650K-W 27-inch Ultrafine 4K UHD (3840 x 2160) IPS Computer Monitor, 60Hz, 5ms, DisplayHDR 400, Reader Mode, Flicker Safe, HDMI, DisplayPort, Tilt/Height/Pivot Adjustable Stand, White
  • Stunning Image Quality in 4K Display - The 27-inch UHD 4K (3840 x 2160) IPS display reproduces clear images and vibrant colors with up to 95% DCI-P3 color gamut expression . Experience dramatic visual immersion with all your favorite shows, movies, sports and games.
  • 4K UHD HDR - To more fully realize content creators vision, this monitor is compatible with VESA DisplayHDR 400 high dynamic range, supporting specific levels of color and brightness that exceed the capabilities of ordinary monitors.
  • Color Your World - Explore HDR content the way it was meant to be seen with up to 95% DCI-P3 color gamut expression—an elevated color spectrum that brings brilliant color to life.
  • Never In the Dark - Light up your gameplay with enhanced vision. Black Stabilizer brightens dark scenes to give you an advantage over the competition—even when they’re hiding in the shadows.
  • Action As It Happens - Get a pro-level experience with the closest thing to real-time gaming. Dynamic Action Sync elevates your gameplay so you can respond every moment of the action with reduced input tag and unbelievable performance.
Rank #4
Sale
UPERFECT 4K Portable Monitor Touchscreen, 15.6” 125% sRGB Laptop Monitor
  • 2026 Innovative 4K Touch Portable Monitor: The innovative 4K touchscreen combines ultra clear 4K resolution with responsive 10-point touch, all within a frameless ultra-thin frame. This is the first product to bring desktop level clarity and finger precision control into a mobile workspace, redefining the way you interact with high-definition content anywhere
  • 4K-125% sRGB True Color Immersion: The 4K UHD (3840x2160) ultra-high resolution of this laptop monitor has excellent accuracy and consistency, with each color tone precisely tuned from the darkest black to the most vivid highlights, creating a profound "immersive" experience - whether you're exploring the vast gaming world or editing high-resolution photos, it takes you to the core of content
  • 2000:1 High Contrast Ratio: White is 2000 times brighter than the darkest black, and this portable screen turns every scene into a dramatic visual masterpiece. Shadows reveal hidden details, highlights burst with luminous intensity, and colors gain unparalleled dimensions, immersing oneself in more realistic, rich, and lifelike images
  • Plug & Play, Widely Compatible: Instantly connect to laptops, phones, tablets, and gaming consoles through USB-C. No drivers, no settings - just plug in anywhere and enjoy the stunning second screen. If you use a MINI HDMI port for connection, you will need to connect a power supply and USB-A to USB-C for touch functionality
  • Lightweight and Powerful Travel Portable Monitor: A lightweight and powerful travel monitor turns any travel destination into an efficient workspace - with vibrant colors, responsive touch, and lightweight portability. Your ultimate mobile studio, preparing for your next trip
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

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

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

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.