Install guides / HTML & custom sites

Install Embent on any HTML site

One script tag, no build step, no framework. If you can edit your HTML, you are done in under a minute.

Before you start

Access to edit the HTML files or templates your site serves.

Steps

Copy your embed snippet

In your Embent dashboard, open your bot's Overview and copy the embed snippet. It looks like this:

<script src="https://api.embent.com/widget.js" data-bot="YOUR_BOT_ID" async></script>

Paste it before the closing </body> tag

Open the file or template that renders every page — on most static sites that is a shared layout or footer include — and paste the snippet just before the closing </body> tag.

Publish your changes

Upload or deploy the edited file the way you normally publish your site.

Check it worked

Reload your site: the chat bubble appears in the corner. Ask it a question about your own pages and it should answer with a citation.

If it doesn't work

Tried it and the widget isn't showing? These fix nearly every case.

I added the embed code but the widget doesn't appear — no chat bubble, no launcher, nothing shows up on my siteFour checks solve almost every "widget not showing" case. First, open your live site and view the page source (right-click → View Page Source) and search for "embent" — if the script is not there, the code was not saved to a published page. Second, make sure the data-bot ID in your snippet matches the one shown in your dashboard under Settings. Third, clear your site's page cache and any CDN cache — a cached page keeps serving the old version without the widget. Fourth, check the bot is not paused in the dashboard: a paused bot deliberately shows nothing to visitors.

The chat bubble appears but replies never arrive, or the widget is missing and my site sets a Content-Security-PolicyAdd https://api.embent.com to both script-src (loads the widget script) and connect-src (the chat reply stream connects back to the same origin). A missing script-src entry hides the widget entirely; a missing connect-src entry shows the bubble but no answer ever streams in.

I use Cloudflare with Rocket Loader and the widget is flaky or missingRocket Loader defers scripts through its own loader. The widget is built to survive that, but if it fails to appear, add data-cfasync="false" to the Embent script tag — Rocket Loader's official opt-out — and the script loads normally.

Common questions

Does it work with React, Vue, Next.js or other frameworks?Yes. Paste the snippet once into the root HTML template — index.html or your root layout. The widget renders inside a Shadow DOM and stays out of your framework's way; no wrapper component needed.

Will it slow my site down?No. The script loads async and the widget is under 50KB gzipped with no framework of its own, so it never blocks your page render.

Do I need to add it to every page?Only to templates that are shared across pages. A page that skips the shared layout needs the snippet added separately.

Point Embent at your site now.An AI agent that would rather say “I don’t know” than make something up. Free plan, no card — most sites are answering within two minutes.

The chat bubble in the corner is Embent itself, running on this page — ask it anything about us.

Start free or try the preview first ↑