Troubleshooting

Widget Not Appearing

1. Confirm Enable Widget is on under Settings → General.
2. The widget appears on single product pages only - not on the shop, category or home pages. On the cart and checkout pages it shows only if Show on Cart Page / Show on Checkout is on.
3. If Category Scope is set, products outside those categories answer "This product is not covered by the assistant."
4. Check the browser console for JavaScript errors from other plugins.

"The assistant is temporarily unavailable"

1. Go to Settings → Connectors and confirm your AI provider is connected and the API key is valid.
2. Check that the same provider is chosen under ShopChat → Settings → General → Select Connector.
3. Check the Chat Logs tab, filtered by Errors, for the provider's message (for example an invalid key or exhausted credit).

Answers About Policies Are Wrong or Missing

The knowledge base is built from your pages, posts and product category descriptions (up to 20 of each).

1. Make sure the policy is on a published page.
2. Click Sync Now on the Knowledge Base tab.

Product details (prices, stock) are always read live from WooCommerce, so they don't need syncing.

Upsell Suggestions Not Appearing

1. Confirm Upsells & Cross-sells is on under AI Behaviour.
2. Set upsells or cross-sells on the product (Product data → Linked Products), or make sure it has related products.

ROI Data Not Recording

1. Revenue is counted on the order-received (thank-you) page - custom checkouts that skip it won't be counted.
2. The shopchat_session cookie must be allowed. Cookie consent plugins that block it stop attribution.

Knowledge Base Sync Not Running Daily

The daily sync uses WordPress cron, which only runs when someone visits the site. On low-traffic sites, set up a real server cron for wp-cron.php, or click Sync Now after changing your pages.