> ## Documentation Index
> Fetch the complete documentation index at: https://www.voiceflow.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Add the Voiceflow widget to Wix

> Add a Voiceflow AI agent to your Wix website with the supplied chat widget. Configure site-wide custom code, test a visitor conversation and maintain the installation.

## Overview

Add Voiceflow’s widget to your Wix website so visitors can ask your AI agent about your products, policies or services. This guide uses **Custom Code** in the site dashboard to install the floating widget across the published site.

**Note:** 

**Building your own interface?** Custom chat and voice walkthroughs are [coming soon](#custom-interface). Start with [Chat agents](/docs/api-reference/agent-runtime/chat) or [Voice agents](/docs/api-reference/agent-runtime/voice) for the APIs.

New to Voiceflow? [Build a support agent](/docs/guides/usecases/customer-service/build-faq-agent), add your help content to Knowledge and publish it first. Installing the widget supplies the conversation interface; it does not connect Wix member accounts or customer records.

<a id="before-you-begin"></a>

## Before you begin

Prepare the published site and the agent it should load.

| Requirement | What to prepare |
| --- | --- |
| Voiceflow agent | A published agent with a floating chat widget, its complete **Widget → Installation** snippet and a known-answer question. |
| Wix site | A published site with a connected domain and access to **Settings → Custom Code**. |
| Site administrator | Someone who can save custom code and return the public test URL. |

Before copying the snippet, open **Widget → Modality & interface** in Voiceflow. Set **Modality** to **Chat** and **Chat interface** to **Widget**, then publish.

Check Wix’s [custom-code requirements](https://support.wix.com/en/article/wix-editor-embedding-custom-code-on-your-site) before starting. Send the complete snippet to your site administrator if they manage this setup. Keep personal and service API keys out of browser code.

<a id="install-widget"></a>

## Install the widget

Load one copy across the site from the dashboard.

### 1. Copy the installation snippet

In [Agent studio](https://creator.voiceflow.com), open your project’s **Widget → Installation** panel and copy the complete snippet, including its script tags. Preserve its generated authorization and environment settings.

### 2. Add Wix Custom Code

In the Wix site dashboard, open **Settings → Development & integrations → Custom Code → + Add Custom Code**. Paste the snippet and name it **Voiceflow widget**.

Use these settings:

| Wix setting | Value |
| --- | --- |
| Add Code to Pages | **All pages** |
| Loading behavior | **Load code once** per visit |
| Place Code in | **Body – end** |

Choose **Apply**. Keep any existing unrelated snippets.

### 3. Check the published site

Open the connected domain in a private browser window. The launcher should appear on the published page. Continue with the [visitor conversation test](#test-conversation).

Use the dashboard’s [custom-code surface](https://dev.wix.com/docs/overview/site-features-tools/about-custom-code), rather than a page’s HTML iframe element. An iframe confines the floating widget to that element. Install it once; do not also load it through a tag manager or another embed.

<a id="configure-widget"></a>

## Configure appearance and sessions

Control the widget without reloading it on every Wix page.

In Voiceflow’s **Widget** settings, choose your launcher, colors and icon, then [publish the changes](/docs/documentation/deploy/environments/publishing). Keep the Wix snippet aligned with the generated installation code if the project or release settings change.

| Visitor action | What to check |
| --- | --- |
| Opens the site | One floating launcher appears. |
| Navigates between Wix pages | The site-wide widget remains usable without another initialization. |
| Reloads or returns later | Conversation retention matches your [widget persistence settings](/docs/documentation/deploy/widget/web-chat-api#configuring-chat-persistence). |

This recipe provides public support. Wix membership and a browser-supplied user ID do not authenticate an agent request. Protected account actions need backend authorization.

For page-specific visibility, work with the site developer and test both navigation directions. Selecting an initial loading page alone does not define when an already-loaded widget should disappear.

<a id="test-conversation"></a>

## Test a visitor conversation

Check the reply on the connected domain, outside the editor.

### 1. Open the public site

Use a private browser window on your connected domain. Confirm that one launcher appears and opens. Test here rather than relying on Wix’s editor preview.

### 2. Ask a question and follow-up

Ask a prepared question, such as “What is your cancellation policy?” Then ask “How do I cancel?” Both answers should match the help content in your agent’s Knowledge.

### 3. Check the project and navigation

Find the exchange in [Transcripts](/docs/documentation/measure/transcripts) to confirm the intended project. Navigate to a second page, send another message and reload. Check that the widget stays usable and follows your persistence settings. If your site uses consent controls, repeat with the relevant consent choices.

<a id="troubleshooting" />

### Custom Code is unavailable

Check the domain, publication and dashboard access.

Confirm that the site is published with a connected domain, and ask the site owner to check your access. An unpublished editor preview does not meet the [custom-code prerequisites](https://support.wix.com/en/article/wix-editor-embedding-custom-code-on-your-site).

### The launcher does not appear

Check the saved snippet and blocked requests.

Confirm the snippet was applied to this site. On the public page, inspect Console and Network for a blocked `cdn.voiceflow.com` request or initialization error. Review consent and security rules with the site owner. If Wix reports incompatible third-party code, use the current Voiceflow snippet and include the browser error when contacting support.

### Navigation restarts or duplicates the widget

Check loading frequency and other installations.

Keep the site-wide snippet set to load once per visit. Remove duplicate Voiceflow installations from other custom-code entries, embeds or tag managers, then reload and repeat the navigation test.

### The answer is wrong or missing

Check the project, release and agent content.

Compare the saved snippet with the Voiceflow project’s generated code. Check that the intended agent is published, then start a fresh conversation. Correct policy gaps in Knowledge or instructions; reinstalling the widget does not update its answers.

<a id="go-live"></a>

## Maintain the live installation

Keep website code and Voiceflow releases in sync.

Applying Custom Code changes the published site; there is no separate widget plugin to activate. For review isolation, use a separate published Wix test site with its own connected domain before applying the snippet to production.

1. Publish the reviewed agent and widget settings in Voiceflow.
2. Apply the correct installation snippet to the production Wix site.
3. Repeat the [visitor test](#test-conversation) on the production domain.

### Update or remove the widget

Review the snippet after agent or domain changes.

Publish later agent and appearance changes in Voiceflow. Replace the Wix snippet when its generated installation details change.

Wix [deletes custom-code snippets when you assign a different domain](https://support.wix.com/en/article/wix-editor-embedding-custom-code-on-your-site). Save a copy before changing domains, add it again afterward and repeat the visitor test.

To remove the widget, delete its Custom Code entry and check the published site in a fresh window. Keep unrelated code entries intact.

<a id="custom-interface"></a>

## Custom interface guides

Planned Wix walkthroughs for your own conversation UI.

Custom chat and voice walkthroughs are **coming soon**, separately from this widget guide.

| Planned guide | API reference |
| --- | --- |
| Add custom chat | [Chat agents](/docs/api-reference/agent-runtime/chat) |
| Add custom voice | [Voice agents](/docs/api-reference/agent-runtime/voice) |
