Wix Integration Guide

QuackChat on Wix

Important Limitations: Wix runs custom HTML in sandboxed iframes, which may limit some widget functionality. See Known Limitations below.

Add the QuackChat widget to your Wix site using the HTML embed element.

Quick Start (TL;DR)

1. Add an Embed HTML element to your page
2. Paste the widget code
3. Publish your site

Prerequisites

• Wix Premium plan (required for custom code)
• Bot ID from your QuackChat dashboard

What Works vs. What May Not Work

What Works

• Widget displays and opens/closes
• Basic chat functionality (send/receive messages)
• Conversation persistence (localStorage within iframe)
• Custom colors and themes

What May Not Work

• JavaScript API calls from your Wix site code
• Cross-page conversation persistence (each page is a separate iframe)
• Advanced integrations with Wix Velo
• Widget positioning may behave differently

Step-by-Step Installation

Option A: Custom Code — Site-Wide (Recommended)

Wix now supports global custom code injection:

1. In your Wix dashboard, go to Settings > Custom Code
2. Click + Add Custom Code
3. Paste the widget code:

<script
  src="https://www.quackchat.app/widget/quackchat-widget.js"
  data-bot-id="YOUR_BOT_ID"
></script>

4. Under Place Code in, select Body - end
5. Under Add Code to Pages, select All pages
6. Click Apply

This installs the widget site-wide without needing to edit individual pages.

Option B: HTML Embed Element (Per-Page)

Use this if you only want the widget on specific pages:

1. Open your site in the Wix Editor
2. Click Add (+) in the left panel
3. Select Embed > Embed a Widget
4. Choose Embed HTML
5. Click Enter Code
6. Paste the widget code:

<script
  src="https://www.quackchat.app/widget/quackchat-widget.js"
  data-bot-id="YOUR_BOT_ID"
></script>

7. Click Update
8. Resize the embed element to be as small as possible (the widget floats independently)
9. Position it in the corner of your page
10. Publish your site

Note: The HTML embed method runs in a sandboxed iframe, which may limit some functionality.

Troubleshooting

Widget appears but is cut off

Cause: Embed element is too small.

Solution: The widget floats, but the iframe boundary may clip it. Try making the embed element larger.

"Premium plan required" error

Cause: Free Wix plans don't allow custom HTML.

Solution: Upgrade to a Wix Premium plan.

Conversation doesn't persist across pages

Cause: Each page loads the widget in a separate iframe with separate localStorage.

Solution: This is a fundamental Wix limitation. Accept per-page sessions.

Known Limitations

Tip: Using the Custom Code method (Option A) avoids the iframe sandbox limitations.

When to Consider Alternatives

If you need full JavaScript API access or cross-page conversation persistence, consider Webflow, WordPress, or Squarespace.