First decide what image you need: for one tall image of the document, use page.screenshot({ fullPage: true }); for a normal browser view, leave fullPage off; and use clip only when you intentionally want a specific region. These options control different things, so none is a universal fix for a sticky header that appears cropped, misplaced, or repeated. The current Puppeteer API documents them separately, with fullPage defaulting to false and captureBeyondViewport defaulting to false when no clip is supplied and true when one is supplied (Puppeteer ScreenshotOptions, displayed version 25.12.0 when accessed).
Identify the screenshot you actually want
A “cut-off sticky header” can mean several different things. Choose the output first, then troubleshoot the matching capture mode.
| Desired output | Starting point | Trade-off |
|---|---|---|
| One tall image of the page | page.screenshot({ fullPage: true }) |
It requests a full-page image; it does not mean the header should be repeated at every scroll position. |
| A faithful image of the current browser view | Use viewport-sized capture without fullPage, at the intended viewport and scroll position. |
Preserves the visible composition and sticky behavior, but captures only the viewport. |
| One deliberate region | Use clip with the desired region and verify its bounds. |
Clipping and capture beyond the viewport interact; a region outside the expected bounds can produce surprising results. |
| A long page represented by successive scroll states | Capture viewport-sized frames and stitch only if that output is required. | Sticky or fixed elements can recur in each frame; stitching is not the same as a single full-page capture. |
The API describes fullPage as capturing the full page, clip as specifying a region, and captureBeyondViewport as controlling capture beyond the viewport (Puppeteer ScreenshotOptions). An element screenshot is another distinct operation: Puppeteer says it tries to scroll an element into view if hidden, but does not present it as a replacement for capturing an arbitrarily tall document (Puppeteer Screenshots guide).
Check the options and reproduce the crop
Make the screenshot configuration explicit before changing the site’s CSS. This example captures a full page after setting a known viewport and waiting for navigation:
Windows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallCrashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minuteconst puppeteer = require('puppeteer');
(async () => {
const browser = await puppeteer.launch();
try {
const page = await browser.newPage();
await page.setViewport({ width: 1440, height: 900, deviceScaleFactor: 1 });
await page.goto('https://example.com', { waitUntil: 'networkidle0' });
await page.screenshot({ path: 'page.png', fullPage: true });
} finally {
await browser.close();
}
})();For a viewport image, omit fullPage. If production code passes clip, reproduce with that exact clip as well; do not assume captureBeyondViewport is irrelevant, since its documented default depends on whether a clip exists.
- Record the environment. Note the installed Puppeteer package version, browser version, headless mode, viewport width and height,
deviceScaleFactor, and every screenshot option, includingclipandcaptureBeyondViewport. The current options page displayed version 25.12.0 when accessed; the historical issues below concern older versions. - Make a minimal reproduction. Use a long, static page with one sticky header and a fixed viewport. Capture once in viewport mode, once with
fullPage: true, and once with the sameclipused in production, if applicable. Keep other settings constant, then compare the resulting dimensions and header position. - Set the viewport before navigation. Let the page’s layout and content settle before capturing. Check whether responsive breakpoints, lazy-loaded content, animations, or application code change the layout around capture time.
- Inspect the whole output. Check the top, middle, and bottom for cropping, duplicate headers, missing content, and layout shifts. Confirm that any temporary style changes are undone.
In an October 24, 2019 maintainer discussion, Puppeteer’s v2.0.0 behavior was described as clipping screenshots to the viewport. The discussion noted that viewport resizing could help scripts that relied on earlier behavior, but also warned that changing viewport size can change vh-based layouts and sticky or fixed positioning. Treat that as historical context, not a current-release prescription (Puppeteer issue #5080).
Choose a header treatment for a tall static image
If a single tall image is the goal and the sticky header’s viewport attachment makes the result unsuitable, test a capture-only CSS override that makes the header static or otherwise removes its sticky/fixed behavior. Keep the change scoped to capture, preserve the original styling, and restore it afterward. This is a troubleshooting strategy, not a guaranteed Puppeteer workaround; verify the result against the intended design.
If the goal is a faithful screenshot of what a visitor sees, do not alter the header CSS. Capture viewport-sized images at the required scroll positions instead. If you stitch those images, expect a sticky or fixed header to appear repeatedly unless your stitching workflow handles it deliberately.
Resizing the viewport is another possible experiment for a version-specific crop, but it changes the page being rendered. A wider or taller viewport can trigger different responsive rules or alter viewport-relative sections, so use it only when that changed layout is acceptable and test the output rather than assuming it preserves the original appearance.
#1 Best Overall
- CRISP CLARITY: This 23.8″ Philips V line monitor delivers crisp Full HD 1920x1080 visuals. Enjoy movies, shows and videos with remarkable detail
- INCREDIBLE CONTRAST: The VA panel produces brighter whites and deeper blacks. You get true-to-life images and more gradients with 16.7 million colors
- THE PERFECT VIEW: The 178/178 degree extra wide viewing angle prevents the shifting of colors when viewed from an offset angle, so you always get consistent colors
- WORK SEAMLESSLY: This sleek monitor is virtually bezel-free on three sides, so the screen looks even bigger for the viewer. This minimalistic design also allows for seamless multi-monitor setups that enhance your workflow and boost productivity
- A BETTER READING EXPERIENCE: For busy office workers, EasyRead mode provides a more paper-like experience for when viewing lengthy documents
Troubleshoot common symptoms
- The screenshot is shorter than expected: Confirm that
fullPage: trueis set for a full-document image and that production code is not applying an unintendedclip. Check the effective clip bounds and thecaptureBeyondViewportsetting against the current API documentation. - The header is cut off in a clipped capture: Compare the clip coordinates and dimensions with the intended region and viewport. Temporarily remove the clip to determine whether the crop comes from the region selection rather than the header CSS.
- The header appears in the middle or more than once: Determine whether the pipeline is capturing or stitching multiple scroll states. Fixed and sticky elements may recur across frames. For a single static image, test a reversible capture-only style change; for browser-state fidelity, preserve the CSS.
- The layout changes when you resize the viewport: Check responsive breakpoints and
vh-based sections. Restore the target viewport and use the capture mode that matches the required artifact rather than treating a larger viewport as a cost-free fix. - The issue appears only in an older deployment: Compare its exact Puppeteer and Chromium versions with the current environment before carrying over a workaround. Puppeteer’s v2.0.0 clipping discussion is historical, and a March 31, 2021 report of a resize symptom under Puppeteer 8.0.0 is one user report—not evidence of a general current bug (Puppeteer issue #7043).
- The header or page shifts around capture time: Keep the viewport fixed, wait for the page to settle, and check for animations, lazy loading, or application-driven layout changes. Reproduce with those factors held constant before attributing the symptom to Puppeteer.
Avoid old Chromium launch-flag suggestions as a first-line fix unless you have confirmed the flag is supported and relevant to the browser version you run.
Or skip the browser setup
ScreenshotNeo can return a website screenshot or PDF from one GET request. For example, save a WebP screenshot of Stripe:
Rank #2
- CRISP CLARITY: This 22 inch class (21.5″ viewable) Philips V line monitor delivers crisp Full HD 1920x1080 visuals. Enjoy movies, shows and videos with remarkable detail
- 100HZ FAST REFRESH RATE: 100Hz brings your favorite movies and video games to life. Stream, binge, and play effortlessly
- SMOOTH ACTION WITH ADAPTIVE-SYNC: Adaptive-Sync technology ensures fluid action sequences and rapid response time. Every frame will be rendered smoothly with crystal clarity and without stutter
- INCREDIBLE CONTRAST: The VA panel produces brighter whites and deeper blacks. You get true-to-life images and more gradients with 16.7 million colors
- THE PERFECT VIEW: The 178/178 degree extra wide viewing angle prevents the shifting of colors when viewed from an offset angle, so you always get consistent colors
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpSee the ScreenshotNeo documentation for request options. Cookie banners are accepted like a visitor and more than 60 known consent platforms, newsletter popups, and chat widgets are removed before capture; each step can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, and response headers report the page verdict and billing status. An MCP server provides take_screenshot, get_page_info, and capture_pdf tools for AI agents. The free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000 shots. Sign up for the free plan.
Frequently Asked Questions
Does fullPage: true repeat a sticky header for every scroll position?
No. It requests a full-page screenshot; it is not a sequence of viewport captures.
Can an element screenshot replace a full-page screenshot?
Not as a general substitute. Puppeteer documents scrolling a hidden element into view, not capturing an arbitrarily tall document.
Quick Recap
Best Value
- 【INTEGRATED SPEAKERS】Whether you're at work or in the midst of an intense gaming session, our built-in speakers provide rich and seamless audio, all while keeping your desk clutter-free.
- 【EASY ON THE EYES】 Protect your eyes and enhance your comfort with Blue-Light Shift technology. This feature reduces harmful blue light emissions from your screen, helping to alleviate eye strain during long hours of use and promoting healthier viewing habits.
- 【WIDEN YOUR PERSPECTIVE】Our sleek minimal bezel design ensures undivided attention. The nearly bezel-free display seamlessly connects in a dual monitor arrangement, delivering an unobstructed view that lets you focus on more at once, completely distraction-free.
Rank #4
- CURVED FOR ENHANCED ENGAGEMENT: An immersive viewing experience with a curved monitor that wraps more closely around your field of vision; It creates a wider view, enhancing depth perception and minimizing peripheral distraction
- SMOOTH PERFORMANCE FOR SEAMLESS CONTENT: Stay in the action when playing games, watching videos, or working on creative projects; The 100Hz refresh rate reduces lag and motion blur so you don't miss a thing in fast-paced moments¹
- MORE GAMING POWER: Gain the edge with optimizable game settings; Color and image contrast can be adjusted to see scenes more vividly and spot enemies hiding in the dark; Game Mode adjusts any game to fill the screen so you can view every detail²
- KEEP IT EASY ON THE EYES: Care for your eyes and stay comfortable, even during long sessions; Advanced eye comfort technology certified by TÜV reduces eye strain by minimizing blue light and reducing irritating screen flicker²
- INCREASED VERSATILITY: Connect to more; Plug devices straight into your monitor for increased flexibility, making your computing environment even more convenient
Rank #3
- Clear visuals. Fluid motion: A 144Hz refresh rate and 1ms MPRT deliver smooth, tear‑free motion across work, gaming, and streaming for clearer, more fluid viewing.
- Eye comfort: TÜV Rheinland 3‑star* certification reduces harmful blue light while preserving stunning color quality without compromise. *TÜV Rheinland 3-star eye comfort certification.
- Wide viewing angle: Get consistent views across a wide 178° /178° viewing angle.
- In-Plane Switching (IPS): See excellent color accuracy and consistency across wide viewing angles with In-plane Switching (IPS) technology.
- Ultra-thin bezels: Maximize your viewing experience with thin bezels.
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.
