Troubleshooting

Widget Not Appearing on the Frontend

1. Confirm Enabled is set to Yes in ShopChat settings.
2. Check that the AI API key is entered and valid - the widget will not load without a valid key.
3. Verify your theme calls wp_footer() - the widget is injected there.
4. Check browser DevTools console for JavaScript errors.
5. If using a caching plugin, clear the cache after enabling ShopChat.

AI Responding with Outdated Product Information

1. Check when the knowledge base was last synced (WooCommerce → ShopChat → Knowledge Base → Last Sync).
2. Click Sync Now to rebuild the index.
3. Confirm the WooCommerce product has been published (draft products are not included).

Upsell Suggestions Not Appearing

1. Confirm Enable Upsells is on.
2. Verify products have upsell or cross-sell relationships set in WooCommerce product editor.
3. If Category Scope is configured, confirm the upsell products are in the scoped categories.

ROI Data Not Recording

1. Check that the woocommerce_thankyou hook fires on order completion (some custom checkout flows skip it).
2. Confirm the ShopChat session cookie is not being blocked by a cookie consent plugin.
3. Verify the {prefix}shopchat_log table exists and has write permissions.

Knowledge Base Sync Failing

1. Check server PHP memory limit - syncing a large catalog requires at least 128MB.
2. Confirm the AI API key has permissions to create embeddings (for OpenAI, this requires text-embedding-3-small model access).
3. Increase WordPress cron timeout if sync times out: add define('WP_CRON_LOCK_TIMEOUT', 300); to wp-config.php.