> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heysonara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Embeddable Widgets

> Embed your voice agent directly on your website.

## What are widgets?

Widgets let you embed a Sonara voice agent directly on your website. Visitors can interact with your agent without leaving your site  - no phone number required.

## Widget types

| Type             | Description                                                |
| ---------------- | ---------------------------------------------------------- |
| **Iframe embed** | A full agent experience embedded in an iframe on your page |
| **Chat widget**  | A floating button that opens a voice/chat interface        |
| **Demo link**    | A shareable URL that anyone can use to test your agent     |

## Adding a widget to your website

<Steps>
  <Step title="Open your agent">
    Navigate to the agent you want to embed.
  </Step>

  <Step title="Click Export / Widget">
    Open the widget export dialog from your agent's settings.
  </Step>

  <Step title="Choose widget type">
    Select the type of widget you want (iframe, chat widget, or demo link).
  </Step>

  <Step title="Configure options">
    Customize the widget appearance and behavior:

    * Widget size/variant (tiny, compact, full)
    * Branding and colors
    * Terms and conditions link (optional)
  </Step>

  <Step title="Copy the embed code">
    Copy the generated embed code and paste it into your website's HTML.
  </Step>
</Steps>

## Example embed code

```html theme={null}
<!-- Sonara Voice Agent Widget -->
<iframe
  src="https://app.heysonara.com/talk-to-agent/YOUR_AGENT_ID"
  width="400"
  height="600"
  frameborder="0"
  allow="microphone"
></iframe>
```

<Warning>
  Make sure to include `allow="microphone"` in the iframe attributes  - the agent needs microphone access for voice conversations.
</Warning>

## Widget variants

* **Tiny**  - Minimal footprint, just a microphone button
* **Compact**  - Small widget with basic controls
* **Full**  - Full-featured interface with transcript and controls

## Demo links

Demo links are the fastest way to share your agent. Anyone with the link can start a conversation  - no website integration needed. Great for:

* Sharing with stakeholders for review
* Quick testing on mobile devices
* Customer demos and presentations

<Info>
  Widgets and demo links are available on the **Basic plan** and above.
</Info>