Wix Integration

Add the Maison concierge chat to your Wix site using the built-in Custom Code panel — no coding experience needed. Wix official site ↗

Before you start

Owner or admin access to your Wix site
Your Client UUID — find it in the Business Console under Settings

Your embed code

Copy this block now and keep it ready — you will paste it in Step 3. Replace YOUR_CLIENT_UUID with your actual UUID from the Business Console.

This code dynamically loads the Maison script and initialises the widget once the script is ready. It also reads a mcbsid query parameter from the URL so returning visitors can resume a previous chat session.

html

<script>
  var script = document.createElement('script');
  script.src = 'https://agent.maison-labs.com/agent-inject.bundle.js';
  script.onload = function() {
    function getQueryParam(param) {
      var queryString = window.location.search;
      var urlParams = new URLSearchParams(queryString);
      return urlParams.get(param);
    }
    var sessionId = getQueryParam('mcbsid');
    var mcAgent = window.initMcbs({
      clientId: 'YOUR_CLIENT_UUID',
      sessionId: sessionId,
      locale: 'en_US',
      // iconPosition: { top: 0, bottom: 20, left: 0, right: 20 },  // Chat icon position (px)
      // onSessionUpdate: function(id) { console.log('Session:', id); },
      // onLocaleUpdate: function(locale) { console.log('Locale:', locale); }
    });
    mcAgent.showIcon();
  };
  document.head.appendChild(script);
</script>

Steps

Open your Wix Dashboard
Log into your Wix account and go to your site's Dashboard.
Navigate to Custom Code
In the Dashboard sidebar, go to Settings > Custom Code. This opens the panel where you can inject code into every page on your site.
Add a new custom code snippet
Click + Add Custom Code. In the text box that appears, paste the embed code you copied above. Make sure YOUR_CLIENT_UUID has been replaced with your actual UUID.
Set to All Pages, Head, Load Once
In the code snippet dialog, configure the following three settings: under Add Code to Pages, choose All pages; under Place Code in, select Head; and under Code loading options, select Load code once. The dynamic script injection in the embed code handles load timing, so placing it in the Head is safe.
Click Apply, then Publish
Click the blue Apply button to save the snippet. Then go back to your site editor and click Publish to make the change live.
Visit your site and verify
Open your live site in a new browser tab. The Maison chat icon should appear in the bottom-right corner. To confirm, open your browser DevTools (press F12), switch to the Elements tab, and look for #maison-chat-icon in the DOM.

For the full list of configuration options, control methods (showChat, hideChat, updateLocale, etc.), and callbacks, see the Widget SDK Reference.

Common mistakes

Forgetting to Publish. Changes in the Wix Dashboard only go live after you click Publish in the site editor. If you saved the custom code but didn't publish, the widget will not appear on your live site.

Not selecting "Load code once". If you choose "Load code on each new page", the script may re-initialise on Wix's client-side navigation and create duplicate chat icons. Always use Load code once.

Forgetting to replace YOUR_CLIENT_UUID. The widget will not load without a valid Client UUID. Copy it exactly from your Business Console — it looks like xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Not sure if it's set up correctly? Use the Site Diagnostic tool.