---
title: Embed in Website
description: Add the Marseil AI chat widget to any website
---


# Embed in Website

## Quick Start

Add this script tag to your site's `<head>`:

```html
<script src="https://app.marseil.ai/embed.min.js" project-id="<your_project_id>" async></script>
```

Get your `project-id` from **Settings**. That's it — the widget shows up as a floating chat button in the bottom-right corner.

## Identify Users (Optional)

If your app already knows who the visitor is, you can pass their details so they show up in chat history. Set the `window.MARSEIL` object before the page finishes loading:

```html
<script>
  window.MARSEIL = {
    userId: "unique-user-id",
    additionalFields: {
      userEmail: "user@example.com",
      name: "Jane Doe",
      avatarUrl: "https://example.com/avatar.jpg"
    }
  }
</script>
```

| Field | What it does |
|-------|-------------|
| `userId` | Unique identifier for the visitor. Shows in chat history. |
| `additionalFields.userEmail` | Visitor email address. |
| `additionalFields.name` | Visitor display name. |
| `additionalFields.avatarUrl` | Avatar image URL. |

You only need `userId` — the rest are optional.

## Framework Notes

The script tag goes in `<head>` for all frameworks. A few need something extra:

**React / Next.js** — Use `react-helmet` to inject the script:

```jsx
import { Helmet } from "react-helmet";

<Helmet>
  <script src="https://app.marseil.ai/embed.min.js" project-id="<your_project_id>" async />
</Helmet>
```

Set `window.MARSEIL` inside a `useEffect` so it runs on the client.

**Angular** — Set `window.MARSEIL` in `ngOnInit`:

```ts
ngOnInit() {
  (window as any).MARSEIL = {
    userId: "unique-user-id",
    additionalFields: { userEmail: "user@example.com", name: "Jane Doe" }
  };
}
```

**WordPress** — Use the [WPCode](https://wordpress.com/plugins/insert-headers-and-footers) plugin. Add a JavaScript Snippet, set insertion to **Header**, paste the embed script.

**Webflow, Wix, Squarespace** — Any builder that lets you insert `<script>` tags works. Add the script to the site-wide head section.

## Troubleshooting

**Widget not visible:** Check that the `<script>` tag is present in the HTML source.

**Project not found:** Verify your `project-id` is correct (from Settings).

**Users not identified:** Open DevTools → Console. You should see:

```
⚙️ Initializing Marseil chat agent
⚙️ Marseil chat loaded
```

If the logs appear but user data isn't coming through, make sure `window.MARSEIL` is set before the page finishes loading.

**Verify the project ID:** In the browser console, run:

```js
document.getElementById("chat-iframe")?.src
```

The URL should contain your project ID (e.g. `/embed/chat/proj_abc123`).

![troubleshoot](/docs_images/integrations-troubleshoot-embed.webp)
