--full-page

CLI: --full-page
REST: full_page

Captures the full scrollable page instead of the viewport. Applies to still images: PNG, JPEG, WebP, TIFF, BMP, JPEG XL, and single-frame GIF, APNG and AVIF. Video output and --image-duration captures are rejected.

Layout Adjustments

The browser scrolls through one viewport at a time and stitches each segment into a single image. Content in scrollable inner containers is expanded, and fixed or pinned elements are captured once. On unusual layouts the result can differ from the screen.

Example

Run locally

zshot --full-page \
  -f page.png \
  https://zshot-cli.com/reference/formats/

{
  "url": "https://zshot-cli.com/reference/formats/",
  "output_type": "png",
  "full_page": true
}

curl -X POST http://127.0.0.1:3000/ \
  -H "Content-Type: application/json" \
  -d '{"url":"https://zshot-cli.com/reference/formats/","output_type":"png","full_page":true}' \
  -o page.png