Skip to main content
SuperBot
Start free
Help · Webflow App

SuperBot for Webflow

Installing the SuperBot chat widget on a Webflow site, what Webflow requires for it to appear, and how to fix the issues that come up most often.

Last updated Questions? Contact us
§ 01

What the App does

The SuperBot App adds the SuperBot chat widget to every page of your Webflow site using Webflow's Custom Code API. There is no manual embed, no Designer edit, and nothing to paste: you authorize the site once and the App registers and applies one versioned, SRI-protected hosted script for you.

  • One reviewed hosted script is registered and applied in your site's header
  • Your SuperBot workspace is created or matched automatically during install
  • Every functional widget update uses a new reviewed script version
§ 02

Before you install

Two things decide whether the widget can appear on your live site, and both are Webflow-side settings rather than anything in SuperBot.

  • Custom code must be available on your plan — that means a paid Site plan, or a site inside a paid Workspace. On the free Starter plan Webflow accepts the API call but does not ship the code
  • You must be able to authorize the site: the install screen asks you to pick a Workspace and then tick the specific site
  • You do not need a SuperBot account before installing; the App creates or matches one during installation using the installing user's email
  • The App requests sites:read, custom_code:read, custom_code:write, and authorized_user:read. It does not read page content, CMS collections, forms, orders, or customers
§ 03

Installing

Start at the App's install link, approve the requested access in Webflow, and you are returned to a dashboard showing the site's status. The dashboard shows "Widget applied" once the script is registered and applied.

  • Choose the Workspace that contains your site, then tick the site itself — approving at Workspace level without selecting a site produces an authorization covering no sites, and the App will tell you so
  • Publish your site afterwards. Custom code only reaches visitors on publish, and that includes the free webflow.io staging domain
  • Reload your published page: the chat launcher appears in the corner
§ 04

Updates and publishing

The App never replaces an approved script with unreviewed code. A functional update is published as a new versioned file with a new SRI hash and submitted to Webflow for review. After an approved update is available, choose Re-apply widget in the App and publish your Webflow site.

  • Your existing Custom Code entries are preserved; SuperBot changes only its own registered script
  • Webflow publishing is required after installation, re-apply, or an update
  • Changing settings or knowledge in SuperBot does not change the reviewed Webflow script
§ 05

The widget is not showing up

Work through these in order — the first two explain almost every case.

  • Have you published since installing? Custom code ships on publish, not on install
  • Is custom code included in your plan? On a free Starter site nothing will render, on staging or live
  • Does the dashboard say "Widget applied"? If it says "Site ID needed", use the retry button there — automatic setup did not complete
  • Did someone remove the code in Site settings → Custom code? Use "Re-apply widget" on the dashboard, then publish again
§ 06

The widget appears but does not answer

That means the widget loaded but is not linked to a live SuperBot workspace. Open the App dashboard: if it shows "Site ID needed", automatic setup did not finish — retry it there. If it shows a SuperBot Site ID and answers are still missing, check that your workspace has published widget settings in the SuperBot dashboard.

§ 07

Multiple sites

One Webflow authorization can cover several sites. Each site keeps its own widget state, and the App dashboard lists them all so you can switch between them and see which ones have the widget applied.

§ 08

Removing SuperBot

Use "Disconnect" on the App dashboard: it removes SuperBot's registered script from the site's applied Custom Code list and revokes the App's Webflow access token in one step. Publish your site afterwards so the widget disappears from the live domain.

  • Removing the App in Webflow without disconnecting also works, but Webflow sends us no uninstall notification — the App detects the revoked token on its next dashboard check and shows a reconnect prompt
  • Uninstalling does not delete your SuperBot workspace or your conversation history; email [email protected] for account deletion
§ 09

Billing and data

The Webflow App is free to install. SuperBot subscriptions are billed separately by SuperBot through superbotapp.ai; current plans and prices are shown on the SuperBot pricing page. Webflow site authorization is used to install and manage the widget, while conversations and widget settings remain in your SuperBot workspace.

  • SuperBot stores the Webflow site identifier, authorization state, workspace link, and script status to operate the integration
  • The App does not read Webflow page content or customer records through the Webflow API
  • See the SuperBot privacy policy and terms for retention, deletion, and support procedures
§ 10

Getting help

Email [email protected] with your Webflow site name and what the App dashboard shows. The dashboard status and any error message on it are the two most useful things to include.

Still stuck?

Email [email protected] with your Webflow site name and the status the App dashboard is showing, or open the live chat in the corner of this page.