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.
On this page
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
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 Data Client requests sites:read, custom_code:read, custom_code:write, and authorized_user:read for installation. The Designer extension can read current-page static text through the Designer API after you choose Read current page. It does not import dynamic CMS content, forms, orders, or customers
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
Training from your Webflow page
Open SuperBot from Apps in the Webflow Designer. Choose Read current page to preview the static text returned by the Designer API, then Save page text to send that preview to your connected SuperBot workspace. This does not crawl a published URL or modify your Webflow page.
- Each save replaces the previous import of the same page; there is no automatic synchronization
- Exit component editing first. Dynamic CMS content, embeds, and text in images are not imported
- You can also enter approved answers and document text in your workspace. URL crawling is unavailable in Webflow-linked workspaces
- Review the imported text and test questions before launch. AI-generated answers can be incomplete or incorrect
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
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 "Setup incomplete", choose Retry automatic setup there
- Did someone remove the code in Site settings → Custom code? Use "Re-apply widget" on the dashboard, then publish again
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 "Setup incomplete", automatic setup did not finish — choose Retry automatic setup 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.
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.
Removing SuperBot
To remove SuperBot from a Webflow site, do these three things in order. The widget stays on your live site until you publish.
- 1. Choose Disconnect in SuperBot's connection settings (open SuperBot from the Apps panel in the Designer, then Open connection settings). This removes SuperBot's script from your site's custom code, revokes SuperBot's Webflow access and deletes the stored access token
- 2. If SuperBot is still listed in your Workspace's Apps & integrations in Webflow, uninstall it there
- 3. Publish your site. Removing custom code only reaches your live site when you publish, and SuperBot never publishes for you
- If you uninstalled SuperBot in Webflow before choosing Disconnect, SuperBot can no longer edit your site. Open Site settings → Custom code, remove any SuperBot script that is still listed, then publish
- Removing SuperBot does not delete your SuperBot workspace, imported page text or conversation history. You can still sign in at superbotapp.ai if you set a password. To delete that data, email support@superbotapp.ai to delete your account
Plans and billing
Installing the App is free, and every workspace starts on SuperBot's Free plan. Paid plans are optional and are billed by SuperBot, not by Webflow. You can upgrade, downgrade or cancel from Billing in your SuperBot dashboard.
- Free: $0, 200 conversations a month
- Starter: $25 a month, 2,000 conversations a month
- Pro: $60 a month, unlimited conversations
- Yearly billing saves 20%: Starter $240 a year, Pro $576 a year
- Every plan includes the full product; paid plans raise the conversation limit and let you customize or remove the SuperBot badge. Your Webflow site plan must support custom code; that is a Webflow cost, separate from SuperBot
Data
SuperBot stores your Webflow site id, site name, domain, the installing user's email, your workspace link, the script status and an encrypted Webflow access token to run the integration. Page text is read through the Designer API only when you choose Read current page and sent to your SuperBot workspace only when you choose Save page text. SuperBot does not import Webflow CMS items, forms, customers or orders.
- The Webflow access token is encrypted, never leaves SuperBot's servers, and is deleted when you disconnect or uninstall
- Imported page text stays in your workspace's Knowledge until you delete it there or delete your account
- Full details are in the Webflow App data section of the SuperBot privacy policy
Getting help
Email support@superbotapp.ai 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 support@superbotapp.ai with your Webflow site name and the status the App dashboard is showing, or open the live chat in the corner of this page.
