RESPONSIVE CONTROL

Capture the responsive layout selected by an explicit viewport

Width and height are product inputs, not decorative options. Use them to request the breakpoint and visible frame your review, documentation, or monitoring workflow actually needs.

Width
Responsive breakpoint
Height
Visible frame
Full size
Viewport or document
Install:width + height + fullSize
Auth:SNAPSHOT_SITE_API_KEY
Get started for free
Responsive viewport capture
Snapshot Site themed screenshot viewport API illustration
Good fits
Responsive QA across known breakpoints
Mobile and desktop documentation images
Visual monitoring with stable dimensions
Preview generation for device-specific layouts

Viewport dimensions define the page state

The same URL can render different navigation, content order, image sources, and controls at another width. Preserve dimensions with every artifact.

1

Width first

Choose widths from the product's actual breakpoints or audience devices.

2

Height intent

Use height for the visible viewport and understand how fullSize changes final output.

3

Stable environment

Keep timing, locale, data, and cleanup consistent between responsive comparisons.

4

Separate baselines

Maintain a distinct approved reference for every monitored viewport.

Implementation workflow

Create a responsive capture matrix

1

Select a small set of meaningful responsive widths

2

Choose viewport or full-page output for each use case

3

Capture the same controlled route and application state

4

Store each artifact under its own viewport identity

Screenshot viewport API example

cURL

Capture a mobile viewport

The explicit dimensions select a mobile responsive state while fullSize remains false for a visible-frame artifact.

curl --fail-with-body --request POST \
  --url https://api.prod.ss.snapshot-site.com/api/v1/screenshot \
  --header "Content-Type: application/json" \
  --header "x-snapshotsiteapi-key: $SNAPSHOT_SITE_API_KEY" \
  --data '{
    "url": "https://example.com/pricing",
    "format": "png",
    "width": 390,
    "height": 844,
    "fullSize": false,
    "hideCookie": true,
    "delay": 1
  }'

Responsive capture begins with CSS pixels

A device label is convenient, but width and height are the reproducible contract. The requested width determines media queries, navigation variants, grid columns, and often which image resource the page loads. Height controls the visible fold and can affect sticky elements or viewport-relative components.

Write the dimensions into the test or monitoring specification. Future reviewers should not need to infer them from the image.

Avoid a device catalog without purpose

More viewports do not automatically create better coverage. Choose a small matrix from actual breakpoints, user analytics, and the routes where layout defects matter. A product may need one compact mobile width, one wider mobile or tablet state, and one desktop state. Another product may need a different set.

Capture representative fixtures before scaling the route list. Confirm fonts, menus, tables, charts, and consent behavior at every chosen width.

Keep baselines independent

Do not compare a mobile image against a desktop baseline or treat their mismatch as a regression. Each viewport is a separate approved state with its own before and after artifacts. Preserve the exact dimensions, format, readiness, cleanup, target version, and capture time.

Full-page mode does not remove the viewport. Width still selects responsive layout; only the output extends vertically. Long captures can also reveal repeated sticky elements or incomplete lazy content, so test them separately from viewport-only images.

Use mobile screenshots for a broader responsive workflow and the visual diff API when each viewport needs controlled before-and-after evidence.

Screenshot Viewport API FAQ

What is a screenshot viewport API?

It lets a capture request specify browser viewport width and height so the target renders at a known responsive state.

Is viewport size the same as output image size?

In viewport mode they are closely related, while full-page capture can produce a taller document image. Rendering and device scaling details should be tested.

Which mobile width should I choose?

Use widths supported by product breakpoints and audience analytics rather than trying to represent every device model.

Can I compare mobile and desktop screenshots directly?

They represent different layouts and dimensions. Maintain separate baselines and review each against the same viewport configuration.

Does changing height trigger a responsive breakpoint?

Most layout breakpoints are width-based, but height can affect visible content, sticky UI, and viewport-dependent components.

How does fullSize interact with viewport dimensions?

The width continues to determine responsive layout, while the output height can extend through the scrollable document.

Should I use device names instead of dimensions?

Store explicit CSS-pixel dimensions even when the UI exposes friendly device labels. Names can hide configuration and become stale.

What else must stay stable for responsive QA?

Keep target data, locale, readiness, consent handling, hidden selectors, output format, and baseline policy consistent.

Define one meaningful responsive matrix

Start with the widths that map to real product breakpoints, then preserve each viewport with its output and baseline.