Add ChatMaxima Web Widget to a Wix Site

Overview

This guide walks you through installing the ChatMaxima web chat widget on a Wix website. Once installed, the chat bubble appears on every page of your site and connects directly to your unified ChatMaxima inbox alongside your WhatsApp, Instagram, Facebook, Telegram, and SMS conversations.

The whole process takes about five minutes and does not require any coding.

Prerequisites

Before you begin, ensure you have:

• An active ChatMaxima account with a configured Web Widget channel
• A Wix Premium plan with a connected custom domain
• Owner or Admin access to the Wix site you want to install the widget on

Note: Wix's free plans do not allow custom code, so the widget cannot be installed on a free Wix site. You must upgrade to a Premium plan with a connected custom domain first.

Step 1: Generate Your Widget Snippet in ChatMaxima

1. Log in to your ChatMaxima dashboard at chatmaxima.com/dashboard/
2. From the left sidebar, navigate to Channels
3. Select Web Widget, then either open an existing widget or click Create New Widget
4. Customise the widget appearance: brand colours, welcome message, logo, and chat window position
5. Optionally enable a pre-chat form to collect visitor name and email
6. Save your changes, then click the Install or Embed Code tab
7. Copy the JavaScript snippet to your clipboard

The snippet is a small <script> tag and loads asynchronously, so it will not slow your site down.

Step 2: Open Custom Code in Wix

1. Sign in to your Wix account at wix.com and open the site dashboard
2. In the left sidebar, go to Settings
3. Scroll down to the Advanced section and click Custom Code

Note: In some Wix dashboards this option appears under Marketing & SEO then Tracking & Analytics. Both routes lead to the same Custom Code panel.

Step 3: Add the ChatMaxima Snippet

1. Click + Add Custom Code in the top right of the Custom Code page
2. Paste the ChatMaxima snippet you copied in Step 1 into the Paste the code snippet here field
3. In the Name field, enter a recognisable label such as ChatMaxima Web Widget
4. Under Add Code to Pages, select All pages and tick the Load code once option
5. Under Place Code in, select Body - end
6. Click Apply

Recommended Settings Reference

Setting	Value	Why
Name	ChatMaxima Web Widget	Easy to identify later
Add Code to Pages	All pages	Widget appears site wide
Load code once	Enabled	Prevents reload on navigation
Place Code in	Body - end	Required for widget to render

The ChatMaxima script must load before the closing </body> tag for the widget to render correctly.

Step 4: Publish and Verify

Custom code only runs on the published version of your site, never inside the Wix editor preview.

1. Open the Wix Editor for your site and click Publish in the top right
2. Once publishing completes, open your live site URL in a new browser tab
3. Look for the ChatMaxima chat bubble in the bottom right corner of your page
4. Click the bubble, send a test message, and confirm the conversation appears in your ChatMaxima Team Inbox

If the test conversation reaches your inbox, your widget is live and working.

Alternative: Embedding the Widget Inline

If you want the chat window to appear inside a specific page section instead of as a floating bubble, use Wix's HTML embed element instead.

1. Open your site in the Wix Editor
2. Click the + Add Elements button on the left sidebar
3. Scroll down to Embed Code and select Embed HTML
4. Paste your ChatMaxima snippet into the code field
5. Drag the embed element to your desired page location and resize it as needed
6. To pin the chat window to one corner of the screen across all pages, right-click the embed element and select Pin to Screen
7. Click Publish

A height of around 622px and a width of 384px works well for most layouts.

Note: The Custom Code method in Steps 1 to 4 is the recommended path for most users. Use the inline embed only if you need the chat window in a fixed page location.

Best Practices

• Test on the live URL since custom code does not run in the Wix editor preview
• Use the Custom Code method for sitewide chat rather than the inline embed, unless you specifically need a fixed page location
• Keep one chat tool active to avoid confusing visitors with multiple chat bubbles
• Enable the pre-chat form in ChatMaxima to capture visitor name and email automatically
• Set up routing rules so Wix conversations land with the right team member

Troubleshooting

The widget does not appear on my site

1. Confirm you are testing on the live published URL, not the Wix editor preview
2. Verify your Wix plan is a Premium plan with a connected custom domain
3. Open the browser console and check for script errors
4. Confirm the snippet was pasted into Body - end, not Head

The widget appears in some browsers but not others

1. Disable any ad blockers or strict tracking prevention extensions
2. Reload the page after disabling
3. Some privacy tools block third party scripts by default, ask your visitors to whitelist your domain

Two chat bubbles are showing on my site

You likely have another chat tool installed, such as Wix Smart Chat, Tidio, or LiveChat.

1. Open your Wix dashboard and go to Settings
2. Find the conflicting chat app and either remove it or hide its widget
3. Reload your live site to confirm only ChatMaxima appears

Conversations are not reaching my inbox

1. Open your ChatMaxima dashboard and go to Channels, then Web Widget
2. Confirm the widget is set to Active
3. Verify your team members are assigned to the correct routing rules
4. Send a fresh test message from the live site

The widget loads slowly

The ChatMaxima snippet loads asynchronously and should not affect your page speed scores. If you notice slow loading, check your Wix site's other custom scripts for conflicts.

Next Steps

• Connect Instagram DM Automation
• Set Up Your Team Inbox
• Train Your AI Bot in Studio
• Configure Routing Rules

Need help? Contact ChatMaxima support at support@chatmaxima.com or chat with us live on chatmaxima.com.