Webflow Integration Guide

Add the widget using Webflow embed blocks.

Easy5 minBasic

QuackChat on Webflow

Add the QuackChat widget to your Webflow site using custom code settings.

Quick Start (TL;DR)

  1. Go to your Webflow Dashboard and open your site's Settings
  2. Paste the widget code in Custom Code > Footer Code
  3. Publish your site

Prerequisites

  • Webflow site with a paid plan (Basic or above)
  • Bot ID from your QuackChat dashboard

Step-by-Step Installation

Option A: Site-Wide via Settings (Recommended)

This adds the widget to all pages on your site.

  1. Go to your Webflow Dashboard where all your sites are listed
  2. Find the site you want and click the three dots (⋯) on the site card
  3. In the dropdown menu, click Settings
  4. Inside Settings, open the Custom Code tab
  5. Scroll down to the Footer Code section and paste:
html
<script
  src="https://www.quackchat.app/widget/quackchat-widget.js"
  data-bot-id="YOUR_BOT_ID"
></script>
  1. Click Save Changes
  2. Go back to your site and click Publish
  3. Select the domains you want to publish to and confirm

Option B: Page-Specific Code

To add the widget to specific pages only:

  1. Open the page in the Designer
  2. Click the gear icon next to the page name (Page Settings)
  3. Scroll to Custom Code
  4. In the Before </body> tag section, paste the widget code
  5. Save and publish

Verification

Quick test:

  1. Publish your site
  2. Open your live website
  3. Hard refresh the page with Ctrl + Shift + R (or Cmd + Shift + R on Mac)
  4. Look for the chat bubble in the bottom-right corner
  5. Click to open and send a test message
  6. Check a few different pages to confirm the chatbot appears site-wide

Important: The widget won't appear in the Webflow Designer preview. You must publish to test.

Troubleshooting

Widget doesn't appear in Designer

Cause: Custom code doesn't run in the Webflow Designer.

Solution: This is expected. Publish your site and view the live version.

Widget not showing after publish

Cause: Publishing may take a moment to propagate.

Solution:

  • Wait 1-2 minutes after publishing
  • Clear browser cache or use incognito mode
  • Check the published URL (not the webflow.io staging URL if using custom domain)

Z-index issues with Webflow navbars

Cause: Webflow navbars often have high z-index values.

Solution: The widget's default z-index (2147483000) already exceeds most site elements. If you still see conflicts, check for elements using near-max z-index values and adjust with data-z-index.

Performance

  • Widget loads asynchronously (won't affect Webflow's page speed)
  • No impact on your Webflow site's performance metrics
  • ~12KB gzipped bundle

Known Limitations

  • Custom code doesn't render in the Designer preview
  • Must publish to see the widget
  • CMS pages all share the same custom code (use JavaScript conditionals for variation)

Stop letting warm leads go cold

Start converting while they're still on your site