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

# Embed the website widget

> Add a call widget to your website so visitors can talk to your agent, with your branding and domain controls.

<Info>
  The website widget lets visitors call or chat with one of your agents directly from your site. You customize its look on the agent's **Widget** tab, then paste a small code snippet into your website.
</Info>

<Steps>
  <Step title="Open the agent's Widget tab">
    Go to `/agents`, open the agent you want to expose, then select **Widget** (`/agents/:id/widget`).
  </Step>

  <Step title="Set the content and appearance">
    Configure:

    * <strong>Title</strong> — the heading shown in the widget
    * <strong>Color style</strong> — a solid color or a gradient preset
    * <strong>Border radius</strong> — None, Small, Medium, or Large

    Use the **Live Preview** tabs (Minimized, Opened, On call) to see how it looks before publishing.
  </Step>

  <Step title="Restrict which domains can load it">
    Under **Security → Allowed Domains**, add the domains allowed to embed your widget. Your organization website is included automatically and can't be removed. Use wildcards like `*.example.com` to allow subdomains.

    <Tip>
      Leaving the list empty restricts the widget to your organization website only. Add each site that should be allowed to show it.
    </Tip>
  </Step>

  <Step title="Save and copy the embed code">
    Click **Save**, then copy the embed snippet from the code block at the bottom of the page and paste it into your website's HTML, immediately before the closing `</body>` tag.

    <Check>
      Reload your site — the widget appears in the corner and connects to your agent.
    </Check>
  </Step>
</Steps>

## Capturing leads from the widget

When a visitor calls through the widget, the agent can collect their details during the conversation so you get a lead record alongside the call — review them on the [Calls](/guides/making-calls) page.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The widget doesn't appear on my site">
    Make sure the page's domain is in the **Allowed Domains** list (or matches a wildcard), you saved the widget, and the embed snippet is present in the page HTML.
  </Accordion>

  <Accordion title="It works on staging but not production">
    Add your production domain (and any subdomains via `*.example.com`) to the allowed domains list.
  </Accordion>

  <Accordion title="Call transfers don't work in the widget">
    Transfers apply to phone calls only, not web calls. See [Transfer calls to a human](/guides/call-transfer).
  </Accordion>
</AccordionGroup>