Mockup mode
Browser-framed screenshots for presentations, docs, and marketing.
Mockup mode wraps your screenshot in a photorealistic browser frame — complete with traffic light buttons, an address bar showing the target domain, rounded corners, and a subtle drop shadow on a gradient background.
Usage
Add "style": "mockup" to your request body:
{
"url": "https://stripe.com",
"style": "mockup"
}Common mistake: Using "mockup": true instead of "style": "mockup". The parameter name is style, not mockup. Incorrect parameters are silently ignored, and you'll get a raw screenshot back.
What the mockup includes
- Browser chrome: macOS-style window with red/yellow/green traffic light dots
- Address bar: Shows the hostname of the target URL (e.g.
stripe.com) - Rounded corners: The browser window has natural rounded corners
- Drop shadow: Soft shadow for depth against the background
- Gradient background: Dark purple gradient behind the browser frame
When to use it
Mockup mode is ideal for pitch decks, blog posts, documentation, social media cards, and any context where you want a screenshot to look polished rather than raw. The composited image is larger than a raw screenshot because it includes the frame and background padding.
Parameters
All standard screenshot parameters work alongside mockup mode. The width and height control the viewport of the page being captured — the mockup frame is added around it.