---
title: "Add your mate to a Wix site | Busymate AI"
description: "Add the embed via Custom Code on Premium or an Embed HTML element on the free plan, let it learn your pages, and recognize signed-in Members."
last_updated: "2026-09-17T20:02:37+03:00"
---
# Add your mate to a Wix site | Busymate AI

Source: https://busymate.ai/ko/docs/guides/wix
Last modified: 2026-09-17T20:02:37+03:00
Wix has no plugin runtime, so Busymate AI reaches a Wix site through the universal embed — and **which plan your site is on decides whether that embed can run at all.** A Wix Premium site unlocks **Settings → Custom Code**: one paste, every page, every visitor. A free `wixsite.com` site does not run third-party scripts: Wix ships every free site with its own renderer flag `shouldLoadAllExternalScripts: false`, so an Embed HTML element, a Custom Element and a Velo-injected tag all stay inert there no matter how they are added. That is Wix's policy, not a limit of the embed.

## Before you start

- A Wix site on a **Premium plan**, published. (A free `wixsite.com` site can still use the hosted chat page below, but not the on-page widget.)
- Your workspace open in the [Console](https://busymate.ai/console).
- The one script tag from your Console connection settings.

## 1. Add the embed (Wix Premium)

1. Go to **Settings → Custom Code** in your Wix dashboard.
2. **Add Code Snippet**, paste:

   ```html
   <script src="https://busymate.ai/embed/v1.js" data-assistant="<your-workspace-slug>" data-label="Ask us" async></script>
   ```

3. Set it to load on **All pages**, placement **Body — end**. Save, then **Publish**.
4. Open the **published** page (not the Editor preview) in a private window and confirm the chat bubble appears.

**On a free Wix site**, link to your hosted chat page instead — `https://<your-workspace-slug>.busymate.ai/chat` — from a button or the site menu. It is the same assistant, the same knowledge and the same Inbox; it opens as its own page rather than as a bubble on yours. Upgrading the site to Premium later turns the paste above on with no other change.

## 2. Teach it your content

Point a [website source](https://busymate.ai/ko/docs/guides/knowledge) at your own Wix URL — the same crawler every connection uses, reading your published pages and citing back to the page an answer came from.

## 3. Recognize signed-in visitors

Wix's **Members Area** is a client-side feature (Velo's `wix-members` API), so identity has to be bridged from your site's own code rather than a server-side plugin: define `window.BusymateAI.getIdentity` (see [Recognize signed-in customers](https://busymate.ai/ko/docs/guides/identified-visitors) for the exact shape) inside a Velo page/site code file, **before** the embed script runs, reading the signed-in member from `wix-members` client-side.

## Manage from any MCP client

Every step above is available from any MCP client on your own account:

{{snippet:claude-code}}

## Troubleshooting

- **The widget never appears on a free site** — this is expected and not fixable from your side. Confirm it the same way we did: open the published page, run `performance.getEntriesByType('resource').filter(r => r.name.includes('busymate'))` in the console (empty on a free site, however the embed was added) and search the page source for `shouldLoadAllExternalScripts` — a free site reports `false`. Premium's Custom Code loads unconditionally.
- **It works in the Editor preview but not on the published page** — always verify on the actual published URL; the Editor's preview runtime can differ from what a real visitor's browser does with a lazy-loaded element.
- **A signed-in member is still treated as a guest** — `getIdentity` must be defined and resolved before the embed script tag runs; test it with `window.BusymateAI.getIdentity()` in the browser console.

## Verify

1. Open your published site in a private window: the chat bubble appears and answers from your own pages, with citations.
2. If you wired identity, sign in as a Wix Member and ask something only a signed-in visitor should see — the reply recognizes that visitor.
3. Ask it to hand off to a person — the conversation reaches your Inbox.

<!-- qa:start -->
### Do I need Wix Premium?
For the on-page chat bubble, yes. Wix disables third-party scripts on free `wixsite.com` sites (its own renderer flag `shouldLoadAllExternalScripts: false`), so no embed method runs there — Embed HTML, Custom Element and Velo alike. On a free site, link to your hosted chat page instead; on Premium, the Custom Code paste works on every page.

### Why does the widget sometimes take a moment to appear?
The loader is `async` and the widget mounts after the page settles, so give a published page a second before deciding it isn't there. On a free plan it will never appear — see above.

### Can I recognize a signed-in Wix Member?
Yes, by bridging `wix-members` to `window.BusymateAI.getIdentity` in your site's Velo code — see [Recognize signed-in customers](https://busymate.ai/ko/docs/guides/identified-visitors).
<!-- qa:end -->

## Next

- **[Teach your assistant your own content](https://busymate.ai/ko/docs/guides/knowledge)** — your Wix pages, crawled and cited.
- **[Recognize signed-in customers](https://busymate.ai/ko/docs/guides/identified-visitors)** — the `getIdentity` bridge for Wix Members.
- **[Set up human handoff](https://busymate.ai/ko/docs/guides/human-handoff-setup)** — staff the Inbox before visitors start asking to talk to someone.