Use this guide to install the AI Agent widget on Wix.
Copy the Embed Code from your portal as described in Installation Overview.Two embed methods are supported:1.
Script-based loader (recommended): Adds an AI Agent bubble. The chat opens in an iframe popover when the visitor clicks the bubble.
2.
Iframe-based embed: Loads the AI Agent directly as an iframe appended to the page body (best for a dedicated page).
Best placement#
Script-based loader: Add using Wix Custom Code and apply it to All Pages. If Wix provides a placement option, choose a placement that runs late (end of body/output).
Iframe-based embed: Add only on a specific page where you want a direct embedded chat experience.
The embed code appends to document.body, so later placement is safer.
Script-based loader (AI Agent Bubble)#
3.
Open Custom Code (location may vary by Wix editor/plan).
5.
Paste the Script-based loader code.
7.
If Wix shows a placement option, choose the option that runs later (end of body/output).
Iframe-based embed (Direct AI Agent Chat)#
This method appends the iframe to the page body and is best used on a dedicated page.Do not use Wix’s plain “iframe URL embed” field for this method, because your embed is a script that creates an iframe. Use an embed type that allows HTML/script.
Steps#
2.
Add an Embed element that supports custom HTML (example: Embed HTML).
3.
Paste the Iframe-based embed code.
To control size, adjust iframe.style.width and iframe.style.height in the code (example: 600px, 80vh, 100vh).
Some Wix embed elements or settings may sandbox scripts. If the embed does not run, use Custom Code for that specific page instead of an Embed element.
Verify installation#
1.
Open the live site in an incognito/private window.
2.
Confirm the bubble or embedded AI Agent loads.
3.
Send a test message and confirm replies.
Troubleshooting#
Confirm the site is published (not just saved).
Confirm Custom Code is applied to all pages (or the correct page).
Hard refresh (Ctrl+Shift+R / Cmd+Shift+R).
If using an Embed element, confirm it supports HTML/script and is not sandboxed.
Check if privacy/cookie settings or security settings are blocking scripts/requests.
Test with browser extensions disabled.
Check browser console for blocked requests or errors.
Ensure the code is not added both via Custom Code and via an Embed element on the same pages.
Ensure the tag is not applied twice across multiple Custom Code entries.
Modified at 2026-02-19 07:24:09