> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Deploy via embed
> Embed your Agent on any website or app so external users can chat with it directly.
Embed your [Agent](/agents/overview) on any website so visitors or team members can chat with it without leaving the page. Choose between a static iframe that's always visible or a floating modal that opens on click.
## Set up the deployment
Go to **Agents** and select the Agent you want to embed. Click **Edit** to open the Agent settings.
Navigate to the **Deployments** tab in your Agent's settings.
Toggle on **Enable Embedded Chat Deployment**.
Click **Add Whitelisted Domain** to specify which website domains are allowed to embed the Agent. You can add multiple domains and remove them as needed.
Enter the **Agent Display Name** that visitors will see in the embedded chat widget.
Enter the **First Message** that greets visitors when they open the chat. Use this to welcome users or prompt them to ask a question.
Select the appropriate **Reference Mode** for your use case:
* **Disable References** — no citations shown in responses
* **Public Sources Only** — only links to publicly accessible sources
* **Include All References** (default) — all citations shown, but users need permissions to view private documents
* **Generate Public Links** — creates public URLs for cited documents
**Generate Public Links** can expose sensitive information. Only use this option if your Agent does not have access to private documents.
Click **Save Settings** to apply your configuration.
In the **Embed Code** section, choose between two formats:
* **Static IFrame** — the chat component is always visible on the page, ideal for support pages or help centers
* **Modal** — a floating button that opens the chat as an overlay, best when you want to offer help without taking up permanent space
Copy the embed code and paste it into your website's HTML where you want the chat to appear. If you're using a website builder, add it to a custom HTML block.
Test the embed on a staging environment before deploying to production. Click
**Preview** in Cassidy to see what the embedded chat looks like before
publishing.
## Regenerate your embed URL or modal
If you need to regenerate the current embed credentials (for example, when you suspect they may have been exposed), click the **Regenerate Embed Url/Key** button. This will create a new embed key or URL and immediately invalidate all existing chats using the old one.
## Next steps
Learn more about creating and configuring Agents.
Deploy your Agent to a dedicated email address.
Build a custom integration using the Cassidy API.