URL parameters
Add these to the src of the embed code, the URL that starts with https://story-api.livedemo.ai/workspaces/....
| Parameter | Example | Effect |
|---|---|---|
step | step=3 | Step to start on. Starts at 1 |
embed | embed | Embedded layout. Already in the embed code |
autoplay | autoplay=true | Plays on its own. See Autoplay |
autoplayDelay | autoplayDelay=4 | Seconds per step when autoplaying. Default 2 |
disableAudio | disableAudio=true | No voiceover or music |
link | link=LINK_ID | Values of a custom link |
vars | vars=eyJjb21wYW55IjoiQWNtZSJ9 | Variable values (below) |
sessionDisabled | sessionDisabled | Don't record this view in analytics |
Example:
https://story-api.livedemo.ai/workspaces/WORKSPACE_ID/stories/DEMO_ID/preview?step=1&embed&autoplay=true&autoplayDelay=4
The https://app.livedemo.ai/livedemos/... share link doesn't pass these parameters on. Use the embed URL.
vars
Set variables from your own code, without creating custom links. Pass a JSON object, base64url-encoded:
const vars = btoa(JSON.stringify({ company: 'Acme', firstName: 'Jane' }))
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, '')
const src = `https://story-api.livedemo.ai/workspaces/WORKSPACE_ID/stories/DEMO_ID/preview?step=1&embed&vars=${vars}`
Rules:
- Up to 20 variables.
- Names start with a letter and use letters, numbers and
_(up to 40 characters). - Values are text or numbers, cut at 200 characters.
varswins overlinkvalues, which win over the defaults.btoaonly handles Latin characters. For other characters, encode the JSON as UTF-8 first.
Use cases
sessionDisabledon internal pages, so your team's views don't count. Or exclude your IPs.stepto open a help-center demo at the relevant step.varswith your logged-in user's name for in-app onboarding.
Next: Embed events
More in Share
- Share your public LiveDemo: Publish your LiveDemo and share a public link so prospects and customers can explore the interactive demo without signing up.
- Public & Private Access: Control who can view your LiveDemo with the Public access switch, and what viewers see when a demo is private.
- Custom Links: Create a LiveDemo link per prospect or campaign with its own variable values, so one demo shows each viewer their own name.
- Custom Domain: Share LiveDemos and AI Demo Agents from your own subdomain, like demos.acme.com, with one CNAME record and automatic HTTPS.
- Preview & Fullscreen: Preview your LiveDemo as viewers see it and present it fullscreen on a sales call or at an event.
- Embed on website: Embed your LiveDemo on your website, landing pages or help center with a responsive iframe snippet.
- Embed Events: Listen to step changes from an embedded LiveDemo and move it to any step from your page with postMessage.
- Embed in WordPress: Add an interactive LiveDemo to a WordPress page or post with a Custom HTML block, in the block editor or Elementor.
- Embed in Webflow: Add an interactive LiveDemo to a Webflow page or CMS collection with a Code Embed element.
- Embed in Framer: Add an interactive LiveDemo to a Framer site with the Embed component.
- Embed in Wix: Add an interactive LiveDemo to a Wix site with the Embed HTML element.
- Embed in Squarespace: Add an interactive LiveDemo to a Squarespace page with a Code block.
- Embed in HubSpot Pages: Add an interactive LiveDemo to HubSpot landing pages, website pages, blog posts and knowledge base articles.
- Embed in Notion: Add an interactive LiveDemo to a Notion page for internal docs, onboarding wikis and public Notion sites.
- Embed in Zendesk & Help Centers: Add interactive LiveDemos to Zendesk Guide, Intercom, HelpScout and other help center articles.
- Embed in React & Next.js: Add an interactive LiveDemo to a React or Next.js app with a small responsive iframe component and listen to step events.
- Share on Medium: Share your LiveDemo in Medium articles so readers can try your product right inside the post.
- Share on X (Twitter): Share your LiveDemo on X (Twitter) with a link preview that drives followers into the interactive demo.
- Share into email platforms: Add your LiveDemo to marketing and sales emails with a preview image that links readers straight into the interactive demo.
- Export in GIF or Video: Export your LiveDemo as a GIF or video to use in social posts, docs, presentations and anywhere iframes are not supported.