Install the Widget on Shopify

Put your widget on every page of a Shopify store with a one-line theme edit. An official BESS AI app for the Shopify App Store is on its way — once it's listed, installing will be a toggle in your theme editor with no code at all.

:::caution Custom pixels won't work Shopify's "Custom pixels" run in a sandboxed context and can't render anything on the page — don't paste the snippet there. Use the theme code edit below. :::

Before you start

You need a widget and its embed snippet:

1. In the dashboard, open Voice Widgets and create a widget (see Website Widgets).
2. Open its Install screen and copy the full snippet (the one-line <script …> tag).
3. Make sure your store's domain (including the .myshopify.com domain if you use it) is in the widget's Allowed domains — without it, the panel won't open.

Add the snippet

1. In the Shopify admin, go to Online Store → Themes, click the ⋯ menu on your current theme and choose Edit code.
2. Open layout/theme.liquid.
3. Paste the full snippet just before the closing </body> tag and Save.

That's it — open your storefront and the launcher bubble appears on every page. Back in the BESS dashboard, the widget's Install screen flips to "widget detected" on your domain automatically the first time any page loads.

note

The publishable key inside the snippet is safe to use publicly — like a Stripe pk_ key, it can only start sessions for this widget's agent and is bounded by your rate limits, daily caps, and credit balance. You can rotate it any time from the dashboard (remember to update the pasted snippet with the new key).

Nothing shows up?

Check three things:

1. The snippet is in layout/theme.liquid of the published theme (not a draft theme), before </body>.
2. Your domain is listed in the widget's Allowed domains in the BESS dashboard.
3. The widget is Active (not disabled) in the dashboard.

Removing the widget

Delete the snippet line from layout/theme.liquid and save — the widget disappears immediately.