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.

Building your own interface? Custom chat and voice walkthroughs are coming soon. Start with Chat agents or Voice agents for the APIs.

New to Voiceflow? Build a support 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.

Before you begin

Prepare the published site and the agent it should load.

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 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.

Install the widget

Load one copy across the site from the dashboard.

1

Copy the installation snippet

In Agent studio, 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:

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.

Use the dashboard’s custom-code surface, 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.

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. Keep the Wix snippet aligned with the generated installation code if the project or release settings change.

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.

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 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.

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.

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.

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.

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 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. 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.

Custom interface guides

Planned Wix walkthroughs for your own conversation UI.

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

Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.