BigCommerce Integration Guide

QuackChat on BigCommerce

Add the QuackChat widget to your BigCommerce store using the Script Manager.

Quick Start (TL;DR)

1. Go to Storefront > Script Manager
2. Create a new script
3. Paste the widget code
4. Save

Prerequisites

• BigCommerce store admin access
• Bot ID from your QuackChat dashboard

Step-by-Step Installation

Option A: Script Manager (Recommended)

1. Log into your BigCommerce admin panel
2. Go to Storefront > Script Manager
3. Click Create a Script
4. Configure the script:
   • Name: QuackChat Widget
   • Description: AI chatbot widget
   • Placement: Footer
   • Location: All Pages
   • Script Category: Essential
   • Script Type: Script
5. Paste the widget code:

<script
  src="https://www.quackchat.app/widget/quackchat-widget.js"
  data-bot-id="YOUR_BOT_ID"
></script>

6. Click Save

The widget will appear on your store immediately.

Platform-Specific Customization

Show on Specific Pages Only

In Script Manager, choose a specific location:

• All Pages: Widget on every page
• Storefront Pages: Only shop pages
• Checkout: Only checkout flow
• All Pages (except checkout): Excludes checkout

Verification

Quick test:

1. Visit your store frontend
2. Look for the chat bubble in the bottom-right corner
3. Test sending a message

Troubleshooting

Widget doesn't appear after saving

Cause: Browser cache.

Solution: Clear cache or test in incognito mode.

Widget conflicts with BigCommerce chat

Cause: BigCommerce has built-in chat options that may conflict.

Solution: Disable BigCommerce's built-in chat in Store Settings.

Widget overlaps with cart preview

Cause: Both elements fixed to corner.

Solution: Use data-position="bottom-left" in the widget code.

Known Limitations

• Script Manager is the only GUI method for site-wide installation
• Theme file changes may be overwritten on updates
• Checkout page scripts require specific placement settings