Install guides / WordPress

Install Embent on WordPress

No theme file to hand-edit. Install a free code-snippets plugin, paste the snippet once, and it loads on every page of your site.

Start free All platforms

Before you start

Self-hosted WordPress.org: no plan or hosting restriction — any site that can install plugins (or edit theme files) can do this.
WordPress.com: requires the Personal plan or higher. The free WordPress.com plan cannot install plugins or add custom JavaScript.

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>

Install a code-snippets plugin

From your WordPress dashboard, go to Plugins → Add New, search for "WPCode – Insert Headers and Footers", and install and activate it. It works the same way on self-hosted WordPress.org and on WordPress.com sites with a plan that allows plugins.

Paste the snippet into the footer

Open the plugin's Code Snippets → Header & Footer screen and paste the snippet into the Footer box, which the plugin loads on every page just before the closing body tag. Save.

Check it worked

Reload your site in a new browser tab: 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 widget still doesn't show and I use a caching or optimization plugin (WP Rocket, Autoptimize, LiteSpeed Cache, W3 Total Cache)Your plugin's JavaScript optimization (minify, combine, defer, or "delay JavaScript execution") is rewriting the Embent snippet. Don't turn the optimization off — add "embent" to the plugin's JavaScript exclusion list (for example WP Rocket's "Excluded JavaScript Files"), then clear the page cache and reload.

Common questions

I'm on WordPress.com — will this work?Yes, on the Personal plan or higher: install WPCode from the WordPress.com plugin directory the same way you would on self-hosted WordPress. The free WordPress.com plan cannot install plugins or add custom JavaScript, so it cannot show the widget.

Can I skip the plugin and edit my theme directly instead?On self-hosted WordPress.org, yes: Appearance → Theme File Editor (Tools → Theme File Editor on block themes), open footer.php, and paste the snippet just before </body>. A theme update can silently overwrite that edit, so the plugin path is more durable. On WordPress.com, the Theme File Editor is available on the same plans as plugins — Personal and up — and not on the free plan.

Will this 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.

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 ↑