embent

Install guides / Shopify

Install Embent on Shopify

One script tag in your theme code, no app to install. If you can open the theme editor, you are done in a few minutes.

Before you start

  • Editing access to your store's theme code (you can only edit a theme's code after it has been purchased/added to your store).
  • The widget will not appear on Shopify's checkout, thank-you, or order-status pages — Shopify blocks custom scripts there for stores that aren't on Shopify Plus.

Steps

1

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>
2

Open your theme code

From your Shopify admin, go to Online Store → Themes. On your current theme, click the ⋯ menu and choose Edit code. Shopify recommends duplicating your theme first, since code changes that are incompatible with a later theme update get removed automatically.

3

Paste it into theme.liquid before </body>

In the Layout folder, open theme.liquid, scroll to the closing </body> tag near the bottom of the file, and paste the snippet just above it. Click Save.

Check it worked

Reload your storefront (not the checkout) 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 chat bubble doesn't appear and I use a speed-optimization app (Booster, Hyperspeed, or similar)Speed apps that "delay JavaScript until interaction" can rewrite or postpone the Embent script. The widget is built to survive that, but if it still does not appear, add "embent" to the app's exclusion list — every one of these apps has one — then reload the storefront.

Common questions

Will the widget show up during checkout?No. Shopify restricts custom code on checkout pages for stores that aren't on Shopify Plus, so the widget appears on your storefront pages but not on checkout, order-status, or thank-you pages.
Will a theme update remove the snippet?It can — Shopify removes code changes that are incompatible with an update when the theme updates. Duplicate your theme before customizing it, and re-check the snippet after any theme update.
Do I need a developer or an app?No. Pasting one script tag is enough — no app install, and no Liquid knowledge beyond finding the closing body tag.
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.