QuackChat on WooCommerce

Add the QuackChat widget to your WooCommerce store for instant customer support on product pages, cart, and throughout your shop.

Quick Start (TL;DR)

Plugins → Add New Plugin → search QuackChat → Install Now → Activate
Settings → QuackChat → paste your Bot ID → Save

WooCommerce runs on WordPress, so everything in the WordPress guide applies. This guide covers WooCommerce-specific behavior.

Prerequisites

WordPress admin access with WooCommerce installed
Bot ID from your QuackChat dashboard (Deploy page → Copy Bot ID)

Step-by-Step Installation

Option A: QuackChat Plugin (Recommended)

In WordPress admin, go to Plugins → Add New Plugin.
Search for QuackChat, then click Install Now on QuackChat Widget, then Activate. (Directory listing)
Go to Settings → QuackChat, paste your Bot ID, and Save.

Can't install from the directory? Download quackchat-widget.zip and use Upload Plugin instead.

On WooCommerce sites the settings page shows one extra option:

Hide on cart & checkout: default off, and recommended off: the assistant keeps answering questions during checkout, and cart-recovery / free-shipping nudges fire on exactly those pages.

Option B: WPCode Snippet (Manual Fallback)

If you can't upload plugins, use the WPCode method from the WordPress guide with this snippet in the Footer box:

html

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

Live Store Answers (Pro)

The widget install above answers from your crawled site content. To let the bot answer live product, stock and order questions (plus product cards and add-to-cart) connect your store with the WooCommerce Store connector (see the "WooCommerce Store: live products & orders" guide). No extra widget config needed: cart features activate automatically when the widget runs on your store's own domain.

Verification

Quick test:

Visit your store's homepage
Navigate to a product page
Look for the chat bubble
Test sending a message

Troubleshooting

Two chat bubbles

Cause: The widget was previously installed via a code snippet (WPCode, theme editor) and the plugin is now also active.

Solution: Remove the old snippet. The plugin replaces it.

Cause: Fixed positioning conflict.

Solution: Switch Position to Bottom left in Settings → QuackChat, or add CSS margin:

css

/* Add to your theme's CSS */
@media (max-width: 768px) {
  .single-product .add_to_cart_button {
    margin-bottom: 80px;
  }
}

Caching plugins serve stale settings

Cause: WooCommerce sites often use aggressive page caching; settings changes don't show until purge.

Solution:

Clear cache after changing QuackChat settings
Exclude widget script from minification/concatenation
For WP Rocket: Add quackchat-widget.js to excluded files

Cause: No conflict expected, but verify in console.

Solution: Check browser console for errors after cart updates.

Performance

Async by default: the plugin injects the script with async. It never blocks your page
Keep the widget on cart/checkout: it's where cart-recovery and free-shipping nudges earn their keep

Known Limitations

Widget doesn't appear in WooCommerce emails
Block-based checkout may have different z-index behavior
Payment gateway overlays may cover the widget

WooCommerce Integration Guide