Skip to main content

Install the Widget on Wix

Put your widget on every page of a Wix site with the built-in Custom Code feature — paste one snippet, no theme edits. An official BESS AI app for the Wix App Market is on its way; once it's listed, installing will be a one-click affair with no code at all.

:::info Wix requirement Wix only runs custom code (and app scripts) on Premium sites with a connected domain. On a free Wix site the widget won't load. :::

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 Wix site's domain is in the widget's Allowed domains — without it, the panel won't open on your site.

Add the snippet​

  1. In your Wix site dashboard, go to Settings → Custom Code (under "Development & integrations") and click + Add Custom Code.
  2. Paste the full snippet and name it BESS AI Widget.
  3. Set Add Code to Pages to All pages and the placement to Body - end.
  4. Click Apply, then publish your site if prompted.

That's it — open your site and the launcher bubble appears in the corner configured in the snippet. 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 four things:

  1. Your Wix plan is Premium and the site has a connected domain (Wix skips custom code otherwise).
  2. The Custom Code entry is applied to All pages and your site has been published since you added it.
  3. Your domain is listed in the widget's Allowed domains in the BESS dashboard.
  4. The widget is Active (not disabled) in the dashboard.

Removing the widget​

Delete (or disable) the Custom Code entry in Settings → Custom Code and publish — the widget disappears immediately.