Troubleshooting StoreAgent Chat widget settings

This article covers the most common issues that come up when configuring the StoreAgent AI Chat Bot — settings that won’t save, the widget not appearing on the storefront, and language-related save errors. If you’re hitting one of these, jump to the relevant section.

“Failed to save chat widget settings” when using a non-English language

Symptom: You translate the chat widget’s welcome message, placeholder text, or assistant name into a non-English language and click Save. The page shows “Failed to save chat widget settings” — but reloading shows the new values did save. Confirmed on Italian, Portuguese, and other locales.

Cause: Earlier StoreAgent builds returned an HTTP 500 from the save endpoint when the request body contained certain non-ASCII byte sequences, even though the database write succeeded. The error toast is the 500 echoing — the data itself is stored correctly.

Fix:

1. Update StoreAgent to the latest version under Plugins → Installed Plugins.
2. Re-save the chat widget settings. The 500 error should be gone.
3. If the error persists, paste the exact WordPress error log entry (from wp-content/debug.log) and your StoreAgent + WordPress + PHP versions into a support ticket so we can debug.

Settings save but the widget doesn’t change on the storefront

Symptom: You update the greeting message, position, or colour, click Save, and see the success toast. But the chat widget on your storefront keeps showing the old values.

Cause: Page caches (server, CDN, or browser) are serving a cached version of the widget bundle that includes the old settings.

Fix:

1. Clear your site cache. The path varies by host — common ones: WP Rocket → Settings → Clear Cache; SiteGround → Speed Optimizer → Caching → Purge SG Cache; Cloudflare → Caching → Purge Everything.
2. Hard-refresh the storefront in your browser (Cmd+Shift+R on macOS, Ctrl+F5 on Windows).
3. Open the storefront in a private/incognito window to confirm the fresh load shows the new settings.

The chat widget isn’t showing up on the storefront at all

Symptom: The chat widget is enabled in StoreAgent settings, settings appear to save fine, but no chat bubble appears on any storefront page.

Fix — check each in order:

1. Confirm Enable Chat Widget is on under StoreAgent → Settings → AI Chat → General.
2. Confirm your StoreAgent.ai account is connected under StoreAgent → Settings → Connection. A disconnected account silently disables the widget.
3. Check Settings → AI Chat → Display. The widget only renders on post types ticked under Display on Post Types, and pages listed under Excluded Pages are skipped entirely. If you’ve excluded the page you’re viewing (or its post type isn’t ticked), the widget won’t load there.
4. Open the page in a private browser window with DevTools open and check the Console tab. Errors from storeagent-ai-for-woocommerce usually point to the cause (account-connection failure, asset load error, plugin conflict).
5. Disable any optimization plugin that defers or combines JS (Autoptimize, Asset CleanUp, WP Rocket’s “Combine JS”) and reload — if the widget appears, the optimizer is interfering. Add the StoreAgent script to the optimizer’s exclusion list.

The chat widget appears but the bot doesn’t reply

Symptom: The chat bubble shows up on the storefront, customers can type a message, but no reply comes back — either it spins indefinitely or shows a generic error.

Fix — check each in order:

1. Check your StoreAgent.ai plan usage. On the dashboard credits counter (top right) — if you’re at 0 credits, replies are blocked until you upgrade or wait for the next reset.
2. Verify your store’s products are indexed in AI Memory. The chat bot relies on indexed content — if 0 products are indexed, the bot has nothing to answer from.
3. Confirm the bot can reach the StoreAgent.ai service. If your host blocks outbound HTTPS, the chat request times out silently. Test by visiting app.storeagent.ai from a browser on your server (or ask your host to confirm outbound HTTPS to app.storeagent.ai isn’t blocked).
4. If the bot replies in chat but the answers are inaccurate, see How to improve StoreAgent Chat answer accuracy.

The widget looks wrong on mobile

Symptom: Widget is positioned, sized, or styled differently on mobile than what you set in StoreAgent → Settings → AI Chat → Styles.

Cause: The Styles tab has separate Positioning values for Desktop, Tablet, and Mobile — easy to miss on a first pass. The mobile preview is at the bottom of the Styles tab.

Fix: Go to Settings → AI Chat → Styles, scroll to the Positioning section, and set the mobile values to match. Save Styles. Clear cache, hard-refresh on mobile.

Need help?

If you have a question or run into any issues, we’re here to help.

• Premium users: Open a support ticket
• Free users: Visit our community forum