Wix

Inclusify installs on Wix as an app from the Wix App Market: add it to your site, open it from your Wix dashboard, and publish. The app adds the widget script for you, needs no Premium plan, and works on a free wixsite.com site.

If you would rather paste the script yourself, it also installs as one Custom Code snippet, added in the site dashboard under Settings Custom Code, scoped to All pages and placed in Body - end. For that route, Wix’s own precondition is not a plan name but a state: the site has to be published and have a connected domain, and connecting a domain is what a paid site plan buys. One dialog, one Apply, one Publish, and the same path applies to Wix Editor and Wix Studio sites.

Installation Steps

1

Install the App

Open the Inclusify listing on the Wix App Market, click Add to Site, choose your site and approve the permissions Wix shows.

2

Open the App in Your Dashboard

Inclusify opens in your Wix site dashboard, and you can come back to it from the dashboard’s apps. The dashboard shows whether the widget is live, and Customize sets its colour and position.

3

Publish Your Site

The app adds the widget script to your site, and Wix runs it on the published site only. Publish from the editor. If the site is already published, there is nothing to do.

4

Check the Published Site

Open your live site and the accessibility icon appears in the corner. Look there rather than in the editor preview, where embedded scripts never render.

Alternative: Custom Code

Custom Code needs a Wix Premium plan with a connected domain. Use one method or the other: running the app and a Custom Code snippet together loads the widget twice.

Register the domain first

Add your domain in the Inclusify panel before you paste the script tag. Bundles are built per registered domain, and an unregistered one fails silently: the script URL still returns HTTP 200, but what it serves is a single console.log saying the domain is not registered. There is no error to find and no widget appears.

1

Open Site Settings

Custom Code lives in the site dashboard, not in the Editor. Go to Settings in the dashboard, then click Custom Code under Development & integrations.

2

Add Custom Code

Click + Add Custom Code in the top right.

3

Paste Widget Code

Paste the following code:

HTML
<script src="https://app.inclusifyapp.com/w/YOUR-DOMAIN.com.js" async></script>

Replace YOUR-DOMAIN.com with your actual domain.

4

Configure Settings

  • • Name: Inclusify Widget
  • • Add Code to Pages: All pages, which also covers pages you create later
  • • Then choose load the code only once per visit rather than on each page the visitor opens. The bundle has no guard against running twice in one document, and a second run mounts a second button.
  • • Place Code in: Body - end. Wix offers Head, Body - start and Body - end; the tag is async, so the last of the three keeps it off the critical path.
5

Apply & Publish

Click Apply, then publish your site to make the changes live.

Notes on Custom Code

  • • The dashboard path is the same for Wix Editor and Wix Studio sites, because Custom Code lives in the dashboard rather than in the editor
  • • Test the published site. Wix treats a published site with a connected domain as the precondition for Custom Code in the first place
  • • Each snippet has its own toggle. Wix’s advice for finding a snippet that is breaking something is to disable them one at a time, which is worth knowing before you start deleting
  • • Google Analytics, Google Tag Manager and the Facebook and TikTok pixels do not work through Custom Code on Wix. That does not affect the widget, but it does mean Custom Code is not the place for your whole tag stack

What needs attention on Wix

Custom Code needs a connected domain, the app does not

Wix's Custom Code instructions open with a precondition rather than a plan name: the site has to be published and have a connected domain. Connecting a domain is what a paid plan buys, which is why Custom Code is effectively paid-only, and why a site still on a wixsite.com address has nowhere to paste the tag. The app is not bound by that precondition: it adds its script through Wix's app platform, so it runs on a free wixsite.com site too.

Changing the site's domain deletes Custom Code snippets

Wix states that code snippets are associated with a specific domain, and that assigning a different domain to the site deletes them. The widget URL is keyed to a domain too, so a domain change on Wix is two steps rather than one: register the new domain in Inclusify, then add the snippet again with the new domain in the script URL.

Wix hardened custom code in December 2025

Wix introduced frontend security measures in December 2025 that can block snippets which used to work until the provider updates them, and the restrictions are specific: you cannot replace window.fetch or XMLHttpRequest, read or write Wix's own cookies through document.cookie, set an iframe srcdoc, open a same-domain window, extend locked globals such as URL, JSON or String, or pass a string to setTimeout. The widget bundle does none of those. It uses fetch as the browser provides it, keeps a visitor's preferences in localStorage, and appends its own elements to the page.

In Custom Code, load the code once per visit

When a snippet applies to all pages, Wix lets you choose between loading it once per visit and loading it on each page the visitor opens. Choose once per visit. The bundle has no guard against being executed twice in one document, so a second execution mounts a second button beside the first.

Verify the installation

  1. Publish the site first. The widget only runs on the published site, whether it came from the app or from Custom Code, so an unpublished site has nothing to check.
  2. Open the published URL in a private window, not the editor preview, and confirm the accessibility icon appears in the corner. Embedded scripts never render in the preview.
  3. If you installed the app, open Settings > Manage Apps in your Wix dashboard and confirm Inclusify is listed and not paused.
  4. If you used Custom Code, return to Settings > Custom Code and confirm the snippet is listed, its toggle is on, and Add Code to Pages reads All pages.
  5. Check the browser console. A snippet that Wix's frontend security has blocked, or a domain that is not registered in Inclusify, both leave a message there rather than failing silently on screen.
  6. If you have snippets from several providers, use the per-snippet toggles to disable them one at a time: Wix's own troubleshooting advice for finding the snippet at fault.

Widget bundles are served from a CDN and cached for a few hours. If you changed widget settings in the panel and the site still shows the old configuration, wait for the cache to expire or load the script URL directly with a cache-busting query string (`?v=2`) to confirm the new version is being served.

Troubleshooting Wix installs

The app is installed and the site is published, but no widget appears.
The app's script has been paused. In your Wix dashboard, open Settings > Manage Apps, find Inclusify and turn it back on, then reload the published site.
The widget does not appear anywhere after installing the app.
The site has not been published. The widget only runs on the published site, so publish from the editor and open the live URL.
The widget does not show in the editor preview.
That is expected. Embedded scripts never render in the Wix editor preview, whether they come from an app or from Custom Code. Check the live site instead.
There is no Custom Code option in Settings.
The site has no connected domain. Wix requires a published site with a connected domain before Custom Code applies, and connecting a domain requires a paid plan, so a site on a wixsite.com address cannot paste a third-party script. Install the Inclusify app from the Wix App Market instead, which works on free sites.
The widget works on the home page but not on others.
The snippet was saved with a page selection rather than All pages. Edit it in Settings > Custom Code and set Add Code to Pages to All pages, which also covers pages you create later.
Two accessibility buttons appear.
The app and a Custom Code snippet are both active, or the snippet is loading on each page rather than once per visit, or it exists both site-wide and on a specific page. Keep one method: pause or delete the snippet if you use the app, and otherwise set the snippet to load once per visit and keep exactly one.
A snippet that used to work has stopped.
Wix's frontend security changes from December 2025 block some previously working custom code until the provider updates it. Check the browser console for an error code, and confirm the snippet is the widget tag rather than a wrapper around it: the widget itself uses none of the APIs Wix restricts.
Everything looks right in the editor but the live site is unchanged.
Custom Code applies to the published site. Press Publish, then hard-reload the live URL.

Wix questions

Do I need a paid Wix plan?
No, not for the app. The Inclusify app from the Wix App Market runs on free wixsite.com sites. Custom Code is different: Wix requires a connected domain for it, and connecting a domain requires a paid plan.
Should I use the app or Custom Code?
The app, unless you have a reason to paste the script yourself. It needs no Premium plan and no snippet, and you set the widget's colour and position inside Wix. Use one or the other, not both: running them together shows two buttons.
Does this work on Wix Studio as well as the classic Editor?
Yes. With Custom Code the path is the same for both, because Custom Code lives in the site dashboard under Settings rather than in the editor. The snippet and its placement are identical.
Should the code go in the head or at the end of the body?
Body - end. Wix offers Head, Body - start and Body - end; the script is async and does not need to run before the page renders, so the last of the three keeps it off the critical rendering path.
Will the widget show up before I publish?
No. The widget only runs on the published site, whether it came from the app or from Custom Code, and it never renders in the editor preview. Test against the published URL.

Wix documentation

Every Wix-specific requirement, menu path and limit on this page comes from these pages. Menus move, so check them against your own admin if something does not match.

Related