Skip to main content

Screenshot Capture

Found in the Elementor panel under Dotjuice → Screenshot Capture.

Before you start: set up your API key

This widget uses the Screenshot Machine API to capture screenshots, which requires a free or paid API key from their service. Go to Dotjuice → Screenshot API in your WordPress admin and enter your key — the widget won't display anything until this is done. See Screenshot API Settings for full setup details.

Content settings

SettingDefaultWhat it does
URLThe web address to screenshot.
Refresh Screenshot buttonEditor only. Forces a brand-new capture immediately, bypassing the cache — use this after the target page has changed.
Full PageOffCaptures the entire scrollable page rather than just the visible viewport.
Cache Limit (days)0How many days a captured screenshot stays cached before it's automatically re-captured on a visitor's page load. 0 means it's captured once and never automatically refreshed — use the Refresh button or clear the cache manually (see below) to update it.
DeviceDesktopDesktop, Tablet, or Phone — captures at that device's typical screen dimensions.
Zoom100%Zoom level applied during capture, from 50% to 200%.
Click ElementEmptyA CSS selector (or comma-separated list) to click before the screenshot is taken — useful for dismissing a cookie banner or opening a menu first.
SelectorEmptyCrop the capture to a specific element on the target page, given as a CSS selector.
Delay (ms)3000How long to wait after the page loads before capturing — increase this for pages with animations or content that loads in after the initial page load.

Display settings (Style tab)

  • Width / Height — the maximum size of the screenshot display area.
  • Website Link — if set, clicking the screenshot goes to this URL instead of the page that was captured.
  • Show Lightbox — opens the screenshot in a lightbox on click (only applies if Website Link is empty). Multiple Screenshot Capture widgets on the same page with this enabled become one swipeable lightbox gallery together.
  • Scroll Speed — for full-page captures only: how fast the image auto-scrolls to reveal the whole page (lower is faster).
  • Border, Box Shadow, CSS Filters, and a Transform popover (rotate, scale, offset, opacity) are available for both the normal and hover states, exactly like Elementor's native Image widget.

Managing your screenshot cache

On the Dotjuice → Screenshot API settings page, a Cache Management panel shows how many screenshots are currently cached and their total size, with a Clear All Cached Screenshots button to force every screenshot on your site to be re-captured on next view. Screenshots are stored in your Media Library, so clearing the cache removes them from there too.

Good to know

  • Every capture uses one API call, whether triggered by a visitor's first view of an uncached page, or the editor's Refresh button. With Cache Limit set to 0 (the default), a given screenshot is only captured once — subsequent visitors see the cached version until you manually refresh it or your Cache Limit expires it.
  • The first visitor to an uncached page waits for the live capture to complete before the page finishes loading. If you're about to publish a page with several uncached screenshots, visit it yourself first (or use the editor's Refresh button on each one) so the cache is warm before real visitors arrive.
  • The editor never triggers an automatic capture while you're designing, specifically to avoid spending API calls while you work — you'll see a placeholder instead until you click Refresh.
  • Changing Cache Limit, Delay, Click Element, or Selector on an already-cached screenshot won't take effect until you use the Refresh button — these settings affect how a new capture is taken, not the one already cached.