Embedding your agent

Two lines of code, paste them onto your website, your agent appears. No deploy step on your end, no build pipeline, no CDN config.

Open your agent's Publish page, then go to the Install tab →

Two ways to embed

Step by step

  1. Open your agent's Publish page and switch to the Install tab.
  2. Pick the embed type, Floating or Iframe.
  3. Add your website's hostname to Allowed domains (e.g. example.com) so nobody else can run your snippet on their site.
  4. Click Copy embed code.
  5. Paste the snippet into your website's HTML, right before the closing </body> tag.

Where to paste it

Tip: Open your site in an incognito window after pasting. The launcher should appear in the bottom right within a second or two.

Is it live? Check the status card

The Install tab shows a Live status card right above the snippet so you never have to guess whether the paste worked. It updates the first time a real visitor loads your page with the snippet on it.

Check again re-checks on demand, so you can paste the snippet, switch back to this tab, and confirm it went live without a full page reload.

Updating the snippet

You don't need to update the snippet when you change the agent's appearance, knowledge, or behaviour. Those updates apply automatically the next time a visitor opens the chat. The only times you'll repaste the snippet are after rotating the widget key (Security settings) or switching to a custom domain (Custom domains).

Widget not showing up on your site?

The most common cause is a domain that isn't on your allow list. If your widget tries to load from a site that isn't in Allowed domains, it is blocked on purpose so nobody else can run your snippet, and the launcher simply won't appear for visitors.

We make this visible for you: open Publish, Install and look just under the Allowed domains box. If we have seen a blocked load attempt, you'll see a note like "We saw a load attempt from your-site.com which isn't in your allowed domains", with a one-click Add button. Click it, save, and the widget starts working there right away.

Testing on your own page? Add ?dante-debug=1 to your site's URL to see a small owner-only message that names the exact domain to add.

Optimisation and caching plugins can break the widget

If the snippet is pasted correctly but the launcher still never appears, the usual culprit is a performance plugin on your site. WordPress optimisation and caching plugins "combine", "minify", "defer", or "delay" JavaScript to speed up page loads. When one of those features swallows our async loader, embed.js either never runs or runs out of order, and the widget silently fails to mount. Nothing in your Dante settings is wrong, the loader just never got a chance to run.

Symptom. The launcher does not appear on your live site (often only after you installed or enabled a speed plugin), but it works in an incognito window with caching off, or on a copy of the site that does not have the plugin.

Fix. Tell the plugin to leave our loader alone. Exclude the Dante script from JS combine, minify, defer, and delay. The script URL to exclude is: 

https://agents.dante-ai.com/embed.js

Most plugins accept a partial match, so just embed.js or dante on its own works too. Here is where each of the common plugins keeps that setting:

After changing any of these, purge the plugin's cache and reload your page in a private window. The launcher should return within a second. The same approach works for any other combine / minify / defer / delay plugin (LiteSpeed Cache, Perfmatters, Hummingbird and similar): find its JavaScript exclusion list and add embed.js.

Widget appears but won't answer

Symptom. The launcher loads and opens and the welcome message shows, but every visitor message gets back "This agent is currently unavailable. Please check back later." instead of a real reply.

Cause. The workspace is out of credits. Replies cost credits, and when the monthly bucket plus any earned or purchased credits reach zero, the agent stops generating answers until the next reset or a top-up. The widget itself is healthy, only the reply step is paused.

Fix. Open Billing to check your balance. Buy the Extra Credits add-on for an immediate top-up, switch the agent to a 1-credit model so each reply costs less, or upgrade the plan for a bigger monthly bucket. See Understanding credits for the full breakdown.

Trouble pasting? We're here.

If the launcher doesn't appear after pasting, send us your website URL and we'll tell you exactly where to put it.

Contact our team →

← Publish Next: Customising appearance →