Skip to content
SupportHQ

Install guides / Wix

Install the SupportHQ widget on Wix

Wix supports site-wide scripts through the Custom Code panel in your site settings. The SupportHQ widget installs there in a few minutes and shows on every page.

Wix has a requirement worth knowing before you start: custom code needs a Premium plan and a connected domain. On a free wixsite.com address the panel is not available.

Requirements: Wix custom code requires a Premium plan and a connected domain. This is a Wix requirement, not a SupportHQ one.

Steps

  1. 1

    Copy your embed code from SupportHQ

    In the SupportHQ dashboard open your project, go to Integrations, choose Web chat, and copy the HTML snippet.

  2. 2

    Open Custom Code in Wix

    From your Wix dashboard go to Settings, then under Advanced choose Custom Code.

  3. 3

    Add the code to the body end

    Click Add Custom Code, paste the snippet, name it SupportHQ, choose All pages, and set the placement to "Body - end". Apply.

  4. 4

    Publish the site

    Publish from the editor. Then open the live site in a private window.

Where it goes: Settings, Advanced, Custom Code, Add Custom Code, placement "Body - end", All pages.

The snippet

Replace YOUR_PROJECT_ID, or copy the ready-made version from Integrations, Web chat in your dashboard.

<script src="https://cdn.supporthq.app/widget/latest/supporthq-widget.js"></script>
<script>
  SupportHQWidget.init({
    projectId: 'YOUR_PROJECT_ID',
  })
</script>
Start free trial Book a call

Things that go wrong on Wix

  • If Custom Code is missing from Settings, the site is on a free plan or the domain is not connected.
  • Choosing "Head" placement can mount the widget before the page body exists. Use "Body - end".
  • Wix Chat (the built-in chat) uses the same corner. Turn it off or set position: "bottom-left" on the SupportHQ launcher.
  • Wix loads pages as a single-page app in some templates. The widget handles navigation without reloading, so one init is enough.

Verify it works

  1. Open the published page in a private browser window. The launcher bubble should appear in the bottom-right corner within a second or two of the page loading.
  2. Click the bubble and ask a question your knowledge base covers. The reply should come from your content. Ask something it does not cover and confirm it says it does not know and offers to bring in a person.
  3. Open the same page on a phone. The panel should open full-height and the keyboard should not cover the reply.
  4. Check the SupportHQ inbox. The test conversation should be there with the page URL in its metadata.

FAQ

Can I use SupportHQ instead of Wix Chat?

Yes. Disable Wix Chat in the Wix dashboard and install the SupportHQ snippet. Conversations then land in the SupportHQ inbox with the AI agent answering first.

Where do I find my project ID?

In the SupportHQ dashboard, open your project, go to Integrations, and choose Web chat. The embed code shown there already contains your project ID and any options you set (theme color, position, required fields). Copy it from there instead of typing it.

Will the widget slow my site down?

The script loads from a CDN. Place it at the end of the body, or use the async pattern shown for React and Next.js, and it will not block your page from rendering. Your content paints first.

Can I put the widget inside the page instead of a floating bubble?

Yes. Add a container element and pass mode: "embedded" and, if needed, container: "#your-id" to init. The chat renders inside that element at the width and height you set.

Related solutions

Further reading