> For the complete documentation index, see [llms.txt](https://docs.supademo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.supademo.com/ai-demo-agent/publishing-and-sharing.md).

# Publishing & Sharing

Publish your Supademo AI Demo Agent, manage draft and live versions, and share it via link, iframe, or popover embed with appearance and security controls.

Publishing promotes your agent's draft to a live version that visitors can reach through a share link, an iframe embed, or a popover embed on your website. Supademo keeps draft and published versions separate, so you can keep editing without touching what's live. This page covers going live, versioning, sharing and embedding options, pre-launch appearance and security checks, and what visitors experience.

***

## Publishing Your Agent

When you're ready to go live, click **Publish** in the top bar. A confirmation dialog appears showing:

* A readiness prompt if your score is low or hasn't been checked.
* A confirmation to promote your draft to the live version.

<figure><img src="https://3896040775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL3ayyYPPw0hy6Yn2UhX0%2Fuploads%2FHoAnl9cGX2NmfIX6KoxB%2Fimage.png?alt=media&#x26;token=fb6b5e91-1e9e-4f1d-a196-5f577a482321" alt=""><figcaption></figcaption></figure>

**What happens when you publish:**

1. The current draft becomes the published (live) version.
2. A new draft is created as a copy, so you can continue editing without affecting the live agent.
3. Visitors will immediately see the newly published version.

### Draft, Published, and Version Management

Every agent has two working states: the **draft** you edit and the **published version** visitors see. Each publish records a new agent version, so the version you're editing and the version that's live are always tracked independently — you can safely experiment in the draft, and nothing reaches visitors until you publish again. \[VERIFY: whether previous published versions can be viewed or restored from the UI]

### Unpublishing

To take an agent offline, open the utility menu (three dots) and select **Unpublish**. This removes the published version entirely — visitors will no longer be able to access the agent.

***

## Sharing Your Agent

Once published, click **Share** in the top bar to access sharing options:

* **Share URL** — A direct link to your agent's public chat page (`/agent/[id]`). Send this to anyone (i.e. sales follow up, early-stage sales conversation).
* **Embed code** — Snippets to place the agent on your website (see embedding options below).

Visitors can also share the agent onward: the redesigned viewer includes built-in **link sharing**, so a prospect can pass the agent along to teammates directly from the conversation.

### Share Warnings

The share flow warns you before you distribute an agent that isn't ready — for example, when the agent hasn't been published yet or your draft has changes that visitors won't see until you publish. Resolve the warning (publish, or confirm you intend to share the older live version) before sending the link. \[VERIFY: exact warning conditions and dialog copy]

***

## Embedding Your Agent

There are two ways to put the agent on your own site:

1. **Inline iframe embed** — An iframe snippet that renders the agent directly in the page. Use this on marketing pages, demo booking forms/pages, and resource centers where the agent is the main content.
2. **Popover embed with a trigger** — The agent opens in a popover launched from a trigger on your page, so it's available on any page without taking permanent layout space. Visitors click the trigger, the agent pops over the page, and they can start a conversation in place. \[VERIFY: exact embed-tab labels for the popover/trigger option]

Pair either embed with the **Allowed embed domains** setting in Security to control where your agent can appear.

***

## Before You Go Live: Appearance and Security

Two settings areas deserve a final check before you publish:

* **Appearance** — The intro screen editor controls the visitor-facing look: heading, logo, CTA button text and colors, and optional name/email form fields. Make sure these match the page the agent will live on. Configured under the Interface tab — see [Getting Started](https://docs.supademo.com/ai-demo-agent/getting-started).
* **Security** — Set **Max conversations per day** (default 5,000, range 1-10,000) to cap usage, and restrict **Allowed embed domains** so the agent can only be embedded on sites you control. Both are configured under Security — see Getting Started.

### Quick Links in the Conversation

The **Quick Links** you configure (up to 20 — booking pages, pricing, signup, docs) are what the agent recommends as next steps once it's live, surfaced to visitors as clickable link cards. Review them before publishing: broken or outdated links are the fastest way to lose a qualified buyer at the finish line. Configure them in the agent editor — see Getting Started.

***

## The Visitor Experience

Here's what your visitors see when they interact with your published agent.

<figure><img src="https://3896040775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL3ayyYPPw0hy6Yn2UhX0%2Fuploads%2FuaFtpnLLJ0YmBKzFNbNl%2Fimage.png?alt=media&#x26;token=dedf441d-67b4-4819-b948-99389b34d46a" alt=""><figcaption></figcaption></figure>

### Landing Screen

1. Your **logo** (if configured).
2. The **heading** from your intro screen settings.
3. **Form fields** (name/email) if configured. Email is validated for business addresses.
4. A **conversation type toggle** (if voice is enabled): "Voice + Text" or "Text only".
5. The **CTA button** with your custom label and colors.
6. A **status indicator**: green dot with "Voice & chat available now" or "Chat available now".

If the agent is unavailable (paused or daily cap reached), visitors see a red indicator with "Currently unavailable, please try again later."

### During the Conversation

* **Text messages** stream in real-time.
* **Content cards** appear inline when the agent recommends a demo, video, or document. These are clickable and open the content directly.
* **Quick replies** appear as tappable suggestions to keep the conversation flowing.
* **Link cards** surface when the agent shares a quick link (pricing, booking page, etc.).
* **Demo walkthroughs** present interactive demos step-by-step within the chat (when available).

<figure><img src="https://3896040775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL3ayyYPPw0hy6Yn2UhX0%2Fuploads%2F5o49sanG1uYaYvhiepyi%2Fimage.png?alt=media&#x26;token=dee717f5-e4ca-4c6b-8a0c-5062f276c993" alt=""><figcaption></figcaption></figure>

The viewer also gives visitors push-to-talk voice input with microphone selection, auto-captions on spoken responses, a collapsible conversation sidebar, fullscreen mode, and a persistent CTA — see [Getting Started](https://docs.supademo.com/ai-demo-agent/getting-started) for the full rundown of the viewer.

### Conversation Recap

When enabled (in Interface settings), visitors see a shareable recap after the conversation ends. The recap includes topics discussed, key takeaways, action items, and assets viewed. Visitors can share this with their team for context.

### Session Limits

| Limit                  | Value                                    |
| ---------------------- | ---------------------------------------- |
| **Maximum duration**   | 20 minutes of conversation.              |
| **Inactivity timeout** | 10 minutes of no activity.               |
| **Expiry warning**     | Shown 2 minutes before the session ends. |

When a session is about to expire, visitors receive a warning. After expiry, the conversation recap is shown (if enabled).

***

Next: [Agent Analytics](https://docs.supademo.com/ai-demo-agent/agent-analytics) — monitor sessions, transcripts, and knowledge gaps once your agent is live.