Skip to content
HTML/CSS to ImageDocs

Real pages are unpredictable. A newsletter modal appears for some visitors, an A/B test moves a button, a cookie prompt slips past the blocker. This guide shows how to script interactions that handle those cases.

Show each tab of a pricing table or feature section:

{
"url": "https://example.com/pricing",
"viewport_width": 1280,
"viewport_height": 800,
"duration_ms": 9000,
"duration_mode": "fixed",
"actions": [
{ "type": "scroll", "steps": [{ "to": { "type": "selector", "selector": "#plans", "offset_y": -40 }, "duration_ms": 1200, "easing": "ease_in_out_cubic" }] },
{ "type": "stall", "duration_ms": 1500 },
{ "type": "click", "selector": "[data-tab='annual']" },
{ "type": "stall", "duration_ms": 2000 },
{ "type": "click", "selector": "[data-tab='enterprise']" }
]
}

click scrolls the element into view first if needed. fixed mode keeps recording after the last click so viewers see the result.

Use locate_selector with a short timeout, and leave the if_not_found branch empty so the recording continues either way:

{
"type": "locate_selector",
"selector": ".newsletter-modal",
"timeout_ms": 2000,
"if_found": [
{ "type": "click", "selector": ".newsletter-modal [aria-label='Close']" },
{ "type": "stall", "duration_ms": 300 }
],
"if_not_found": []
}

For a single click, click with "if_not_found": [] is shorter:

{ "type": "click", "selector": "#cookie-accept", "timeout_ms": 1500, "if_not_found": [] }

If a missing element means the video would be wrong, fail on purpose instead of producing a misleading recording:

{
"type": "click",
"selector": "#start-demo",
"timeout_ms": 5000,
"if_not_found": [{ "type": "error" }]
}

The recording ends as failed with action_error, and action_path shows the branch that failed, for example actions[2].if_not_found[0]. See errors.

Branch on which version of the page loaded:

{
"type": "locate_selector",
"selector": "#new-hero",
"timeout_ms": 1000,
"if_found": [{ "type": "click", "selector": "#new-hero .cta" }],
"if_not_found": [{ "type": "click", "selector": ".hero .button", "if_not_found": [{ "type": "error" }] }]
}

Branches don’t inherit selectors. Every action in a branch has its own selector.

For things a click can’t do, like typing into a field, changing a dropdown, or calling an app API, use execute_javascript:

{
"type": "execute_javascript",
"script": "const input = document.querySelector('#search'); for (const ch of 'html to video') { input.value += ch; input.dispatchEvent(new Event('input', { bubbles: true })); await new Promise(r => setTimeout(r, 80)); }",
"timeout_ms": 5000
}

This “types” one character every 80 ms. Frames keep being captured during each await, so viewers see the text appear.

If the script fails or times out, the recording fails unless you add if_error. Use "if_error": [] to ignore failures, or give it fallback actions.

  • To wait for content before recording starts, use an element_visible trigger. The loading state stays out of the video.
  • To wait for something during the recording, give click or locate_selector a timeout_ms. They continue as soon as the element appears, which is better than a fixed stall.

Need help?

Talk to a human. Email support@htmlcsstoimage.com and we’ll help you get started.