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 desk5 min

How to Fix Low-Resolution Screenshots from Chrome Headless

Find out whether a Chrome Headless screenshot is undersized, under-scaled, cropped to the viewport, or captured before the page finishes rendering.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

First check whether the screenshot has the wrong viewport dimensions, too few pixels for the desired scale, or simply omits content below the fold. For a basic Chrome Headless capture, set --window-size=WIDTH,HEIGHT alongside --screenshot, then inspect the PNG’s actual dimensions. If those dimensions are correct but the image looks underscaled, investigate headless screen scale; if the image cuts off the page, use a full-page capture method instead.

Diagnose what “low resolution” means

A screenshot can look too small or incomplete for different reasons. Compare the intended CSS viewport with the PNG’s pixel dimensions, then check whether the page content itself rendered before capture.

As an Amazon Associate I earn from qualifying purchases.

What you see Likely issue What to check
The screenshot’s width or height is smaller than intended Capture window or viewport dimensions Set explicit dimensions with --window-size and verify the output file.
The layout has the expected dimensions, but the PNG has fewer pixels than expected Pixel scale or device scale factor Check headless screen scale configuration and your automation library’s device emulation settings.
The image dimensions are right, but content below the fold is missing Viewport-only capture Use a full-page screenshot method; increasing the viewport or pixel scale is not the same as capturing the full document.
Elements are missing or unfinished Capture occurred before rendering completed Adjust capture wait or timeout behavior.

Record the installed Chrome version, capture command or automation API, intended CSS viewport, desired PNG pixel dimensions, and actual PNG dimensions. Those details distinguish the four cases.

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

Set the capture window size for a CLI screenshot

Chrome’s command-line reference pairs --screenshot with --window-size to control the capture window. For example, this requests a 412-by-892 window:

#1 Best Overall
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.
chrome --headless --window-size=412,892 --screenshot=shot.png https://example.com

Replace chrome with the executable name or path for your installation, and replace the URL and dimensions with your target. Chrome documents --window-size=412,892 as an example in its Headless command-line reference.

  1. Run the command with explicit width and height.
  2. Inspect the resulting PNG’s pixel dimensions using your image viewer or image-processing tool.
  3. Compare those dimensions with what you intended to request. If the width and height are correct, do not keep enlarging the window to solve a scale-factor problem.

The window dimensions determine the capture area. They do not, by themselves, establish that the output has the higher pixel density you may expect.

Rank #2
Sale
LG 27US500-W Ultrafine Monitor 27-Inch 4K UHD (3840x2160) HDR10 IPS Borderless Design Reader Mode Flicker Safe Switch App HDMI DisplayPort - White
  • 4K UHD with 1000:1 Contrast Ratio - This UltraFine display with a 1000:1 contrast ratio displays deeper blacks and vivid colors in UHD clarity. With wide viewing angles, it gives creative professionals the ability to view and work with highly-detailed, digital imagery.
  • 4K HDR10 DCI-P3 - Explore HDR10 content the way it was meant to be seen with up to 90% DCI-P3 color gamut expression—an elevated color spectrum that brings brilliant color to life.
  • Onscreen Control - You can customize the workspace by splitting the display or adjusting basic monitor options with just a few mouse clicks.
  • Ergonomic Stand - The ergonomic stand makes it easy to flexibly adjust the tilt of the screen in the optimal position for you.
  • What's In The Box - Stand Body, Stand Base, Screws, Power Adapter, HDMI Cable, Quick Start Guide, Registration Card, Warranty.

Check headless screen scale when the output has too few pixels

If the CSS layout is the right size but the image has fewer pixels than expected, investigate the device scale factor or headless screen scale separately from the viewport. Chrome’s virtual-screen documentation describes headless screen properties, including size and scale factor, as configurable independently of physical displays attached to the machine.

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

Chrome documents --screen-info for static virtual-screen configuration. These newer virtual-screen capabilities are available in stable Chrome starting with version 142, so check your installed version before relying on that switch. See Chrome’s virtual-screen configuration guide for the supported configuration and details.

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

If you use Puppeteer or another automation library, check its version-specific screenshot and device-emulation options. Chrome’s virtual-screen guide says the new capabilities are supported by Puppeteer; do not assume that an option or syntax from one library release applies to another.

Use full-page capture when lower content is missing

A screenshot with correct pixel dimensions can still show only the visible viewport. That is a capture-coverage issue, not low resolution. Chrome’s older Headless shell documentation notes that full-page screenshots require additional handling: use a full-page capture facility provided by your automation API or another method appropriate to your Chrome and library versions. Simply increasing the window size or scale does not guarantee capture of the entire document.

Rank #4
Samsung 27" Odyssey G5 (G51F) Series QHD (1440P) Gaming Monitor
  • QHD Resolution (2560 x 1440) has 1.7 times the pixel density of Full HD for incredibly detailed pinsharp images
  • HDR10 provides brighter highlights and nuanced shadow for added depth - making every scene feel more vivid and realistic
  • The 180Hz refresh rate minimizes lag for gameplay with ultra-smooth action. Plus, the 1ms response time helps capture your moves in real-time, allowing you to react fast for gaming precision
  • AMD FreeSync reduces choppiness, screen lag and image tearing, ensuring that your fast-paced, complex in-game action is stable with minimal stutter
  • Ergonomic stand allows for tilt, pivot and height adjustments to maximize gaming comfort

For library-specific setup, consult the documentation matching your installed version. Avoid carrying older Headless shell platform-specific flags into a current setup unless the current documentation for your environment calls for them.

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.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Wait for the page to render before capture

If content is missing because the page has not finished loading, Chrome’s --timeout option lets screenshot capture wait up to a specified time even if the page is still loading. For time-dependent scripts, Chrome also documents --virtual-time-budget. These options can change when Chrome captures the page; they do not increase pixel density.

Best Value
Dell 27 Monitor S2725QC, 4K UHD IPS, 120Hz, 99% sRGB, 4ms, FreeSync Premium
  • Low blue light: The 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.
  • Easy connectivity: Keep your desk organized and clutter-free with a single USB-C cable (up to 65W power delivery).

Choose a wait appropriate to the page’s behavior, then check whether the missing content appears. A longer wait cannot fix an incorrect viewport, scale factor, or full-page setting.

Troubleshoot common capture problems

  • PNG is smaller than the requested viewport: Confirm that --window-size=WIDTH,HEIGHT is present in the CLI invocation and inspect the actual file produced. If using a library, review its viewport configuration for your installed version.
  • Viewport looks right, but pixel dimensions are still too small: Check device scale or virtual-screen scale. On stable Chrome 142 or later, consult the --screen-info virtual-screen configuration documentation.
  • Bottom of the page is absent: Switch from a viewport screenshot to a full-page screenshot facility. Raising the viewport dimensions is not a substitute for full-document capture.
  • Page elements are blank or incomplete: Adjust the screenshot timeout or wait for relevant page activity to finish. Timing options affect readiness, not resolution.
  • A virtual-screen option is not recognized: Check the installed Chrome version; the newer virtual-screen capabilities described by Chrome are available in stable releases beginning with version 142.
  • Automation settings do not behave as expected: Match screenshot and device-emulation configuration to the exact version of Puppeteer or other library in use.

Or skip the browser setup

ScreenshotNeo is a website screenshot API and MCP server. A single GET request returns an image or PDF; for a straightforward screenshot, use this cURL example:

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 setup and options. ScreenshotNeo accepts cookie or consent banners like a visitor and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; those steps can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, and response headers identify the page verdict and billing status. Its MCP server lets AI agents use screenshot tools, and the service includes 1,000 screenshots a month free with no card; paid plans start at $5 for 3,000. Sign up for the free plan.

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

Frequently Asked Questions

Does increasing --window-size make a screenshot higher density?

It changes the capture window dimensions. If the layout size is already right but you need more output pixels, check the device or headless screen scale separately.

Does --timeout improve screenshot resolution?

No. It can give a page more time to load before capture, but it does not change pixel density.

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
Outdated Drivers Are Slowing You DownFree scan - exact matches
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.