How it renders
The demo loads the target site in one of two ways. By default it mirrors the live page in an iframe. If you passscreenshot=true, it loads a cached static image of the page instead.
| Mode | What you see | When to use |
|---|---|---|
| Mirror (default) | The live page proxied into an iframe | Most sites. Closest to the real experience. |
Screenshot (screenshot=true) | A cached static image of the page | Heavy SPAs or sites with strict CSP / framing rules that refuse to render in an iframe. |
screenshot=true on the link directly.
The overlay also self-heals the URL: if https:// fails to load it retries with http:// before giving up.
Get the link from the deployment screen
The shareable link is generated for you on the agent’s deployment screen once the web widget is published.Publish the web widget
Open your agent, go to the deployment section, and turn the web widget channel on. The link only appears when the widget is in a published state.
Find Shareable Test Link
In the web widget card, locate the Shareable Test Link block: “Preview your widget on any website and share the link with your team.”
Enter a website
Type the website you want to demo on (for example
https://example.com) into the URL field. The agent’s configured company URL is prefilled when available.The generated link normalizes the website to its base domain so it matches the pre-warmed screenshot cache. When the agent’s screenshots are ready, the deployment screen adds
screenshot=true to the link for you so the demo loads instantly.Link reference
The demo lives at the public path/public/cloned-websites and is configured entirely through query parameters.
| Parameter | Required | Description |
|---|---|---|
site | Yes | The website to render. Use the bare domain (for example example.com) so it matches the screenshot cache. |
url | — | Alternative name for site. If both are present, site wins. |
widget_id | — | The widget to overlay. Without it, the page renders the site but loads no agent widget. |
screenshot | — | true loads a cached static screenshot; any other value (or omitted) uses live mirror mode. |
open | — | Controls whether the widget opens automatically. Defaults to open; set open=0 to start collapsed. |
signup_cta | — | Pass signup_cta=1 to show the widget’s sign-up call to action. |
agent_name | — | Display name passed through to the widget. |
industry | — | Industry hint passed through to the widget. |
distinct_id | — | Analytics identifier passed through to the widget for the demo session. |
If
site (or url) is missing, the page renders a “Missing required query parameter” message. The widget itself only loads once both widget_id is present and the page content is ready.Related
Web widgets
Configure and embed the chat widget this demo overlays.
Testing agents
Try your agent before sharing a demo.
Knowledge Bases
Ingest website content so your agent can answer from it.

