Skip to content

Screenshot route body parameters ​

To render a screenshot, set screenshot under the page property:

screenshot properties for screenshot routes ​

These properties follow Puppeteer's ScreenshotOptions type.

Property nameTypeDescription
captureBeyondViewportbooleanCaptures the screenshot beyond the visible viewport. optional
clipScreenshotClipAn object which specifies the clipping region of the page. optional
fullPagebooleanWhen true, takes a screenshot of the full page. optional
omitBackgroundbooleanHides default white background and allows capturing screenshots with transparency. optional
qualitynumberImage quality, between 0 and 100. Not applicable to PNG images. optional
type'png', 'jpg', 'jpeg', 'webp'Image format, default is png. optional

⚠️ WARNING

  • clip and fullPage cannot be used at the same time. They are mutually exclusive.
  • quality cannot be used with the PNG format.
  • If you define quality, you must also set type to jpg, jpeg, or webp.

clip properties ​

Property nameTypeDescription
widthnumberWidth of the area to capture.
heightnumberHeight of the area to capture.
xnumberX coordinate of the capture area.
ynumberY coordinate of the capture area.

All rights reserved