> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/en/sharing/publish-your-agent/embed-your-agent-on-a-website.md).

# Embed your agent on a website

Embedding an Agent lets users interact with it directly inside your website or web application without leaving the page.

For most websites, the easiest approach is to start from a sharing layout and use the embed code generated by AIsuru.

### Get the embed code

To obtain the code for a layout:

1. Open the Agent management panel.
2. Go to **Share me**.
3. Create a new layout or open an existing one.
4. Open button in the **Embed code** section of the layout.
5. Copy the generated code.

If you need help choosing or configuring the experience first, see [Sharing layouts.](/en/sharing/sharing-layouts.md)

### Add the Agent to your website

Once you have copied the code:

1. Open the editor, CMS, or source code of the page where you want the Agent to appear.
2. Paste the generated code in the appropriate section of the page.
3. Save your changes.
4. Test the page before publishing it to your live website.
5. Publish the page when the integration behaves as expected.

Testing in a private or staging environment gives you time to adjust the layout, styling, dimensions, or position before visitors use it.

### Why embed the Agent?

Embedding keeps the interaction inside your website, so users do not need to open a separate AIsuru page.

You can also create a layout specifically for the website and align its appearance with the surrounding page using the normal Sharing Layout options.

### Private Agents

If the Agent is configured as private, users may be required to provide the Agent password before they can interact with it.

Review Access and visibility when the embedded experience should be restricted to specific users or audiences.

### Web applications and deeper integrations

The generated embed is based on the AIsuru Web Component rather than an isolated iframe-only integration.

This allows advanced web applications to integrate the Agent more deeply with the host page, for example by passing context, reacting to Agent events, sending messages from custom interface elements, or coordinating the Agent with other page content.

You do not need these capabilities for a standard website embed.

For developer-level integration, see [Advanced embed and web integration.](/en/sharing/publish-your-agent/advanced-embed-and-web-integration.md)