Last updated: 2026-10-25
Before you start
This guide uses PrimeWebKit's standard website widget: one external script that loads the chatbot configured in your account. It does not install a native Webflowplugin or automatically connect your site's private data. The platform-specific steps below explain where the snippet belongs and what to verify before making a live change.
- A published PrimeWebKit bot and the complete script copied from its Widget tab.
- Webflow site access with permission to edit custom code and publish the site.
- Confirmation that the current Webflow plan supports the site-wide code-injection feature you intend to use.
- The live site's domain in the bot's allowed-domains setting if the widget is domain-restricted.
Installation steps
1. Open the site's custom-code settings
Editor or file path: {{VERIFY: Webflow Dashboard → current site settings → Custom Code; confirm the exact labels and plan requirements in Webflow help}}
Open the settings for the correct Webflow site and use the current official Webflow instructions to locate a site-wide footer or before-body-end field. The code-injection path has not been verified in this project's existing install docs, and Webflow may change where settings appear.
2. Add the script to the shared footer
Editor or file path: {{VERIFY: Site settings → Custom Code → Footer code or equivalent body-end field}}
Paste the snippet copied from the PrimeWebKit Widget tab into the shared footer field, keeping the bot ID exactly as supplied. Avoid adding it to a single page's embed component when you want a site-wide bubble, and avoid duplicating it in both global settings and individual pages.
3. Publish to the intended domains
Editor or file path: Webflow Designer → Publish; select the intended staging or custom domain (verify current controls)
Save the settings and publish to the domain you plan to test. If you first test on a Webflow staging subdomain, add that domain to allowed domains when restrictions are on, then add the production domain as well. Confirm the live site includes the updated script before troubleshooting the bot itself.
The menu paths marked {{VERIFY}}are not confirmed by the existing project documentation. Check the platform's current first-party help and your account's available features before applying them.
Widget snippet
Copy the snippet from the selected bot's Widget tab whenever possible. The example below shows the format for your reference; replace the example identifier only with the bot ID from your own copied snippet.
<script src="https://api.primewebkit.com/widget.js" data-bot-id="YOUR_BOT_ID" async></script>
Example format only. Copy your exact snippet from the Widget tab and confirm Webflow accepts external scripts in the chosen site-wide field.
Platform-specific notes
Publishing to a staging domain and a custom domain may be separate actions. Test each domain where the bot should appear, and make sure the allowed-domain list in PrimeWebKit includes the exact host visitors use.
A Webflow page-level embed and a site-wide footer field are not interchangeable in scope. Use the shared footer only after confirming the setting supports external scripts and publishes to every required page.
Before publishing, review any site-wide consent banner, security policy, and domain restrictions already in place. Add the widget only to the pages and hostnames where it is intended to run, and avoid copying account secrets or private customer data into the page source.
Verify the chatbot is working
Test a published page, not just an editor preview. Confirm the launcher is visible, opens when activated, and accepts a question. Ask something answered by the bot's current knowledge sources, then check that an unrelated or unsupported question is handled within the limits of the bot's instructions.
Repeat the check on another page that shares the layout and on each hostname visitors use, such as a staging host and the production domain. If the bot is restricted to allowed domains, include the exact hostname for each environment before testing. Inspect the browser console and Network panel if the script or API request fails; record the specific error rather than changing unrelated settings.
Common problems
The widget does not appear
Confirm that the page was published with the script, the bot ID is correct, and the exact site hostname is allowed in the bot's domain settings. Check the browser console and Network panel for blocked or failed requests, then clear the site's page cache and test the public page again.
A cache or optimization tool serves an old page
Purge the relevant page, hosting, or CDN cache after publishing. Temporarily compare the public page in a private browser window and inspect its page source for the script before changing other settings. Avoid disabling all optimization or security features as a first step.
A content-security policy blocks the script
A CSP can prevent the browser from loading an external script or connecting to the widget service. Read the exact blocked origin in the browser console, then have the site administrator update only the applicable script-src or connect-src policy after verifying the required host. Do not use a wildcard policy as a workaround.
A builder or plugin changes the injected code
Some page builders, script managers, and cache plugins defer, rewrite, or sanitize custom code. Check the published HTML and console, confirm the tool supports external scripts in the chosen location, and remove duplicate copies before trying another injection point.
Frequently asked questions
Where do I get the Webflow chatbot script?
Open the bot you want to publish in PrimeWebKit, go to its Widget tab, and copy the complete snippet shown there. Use that bot-specific script and ID rather than a placeholder or a snippet from another bot.
Can the chatbot appear on every Webflow page?
Yes, when the script is added once to a shared site-wide layout or footer that is included on those pages. If you place it in a page-specific block or template, it may only appear on that page. Test more than one public page after publishing.
Do I need a Webflow plugin?
No PrimeWebKit Webflow plugin is required by this guide. It uses a custom script field; verify that Webflow currently offers this feature on your plan.
What should I check if the widget is missing?
Check that the latest page was published, the script and bot ID are present, and the tested hostname is allowed in the bot settings. Then inspect the browser console and Network panel for blocked or failed script requests and clear relevant caches.
Can a content-security policy block the chatbot?
Yes. A restrictive CSP may block the widget script or its network requests. Use the exact blocked origin reported by the browser and ask the site administrator to update the relevant policy narrowly; do not add wildcard permissions.
How do I avoid loading the widget twice?
Place the script in one shared insertion point only. Do not add a second copy in a page block, another theme file, or a script plugin if it is already in the global layout. Check the rendered page source when troubleshooting duplicate launchers.