Skip to main content
Docs menu

Docs / Troubleshooting & FAQ

Widget not showing on your storefront

Work through these in order — each one is a real, specific setting that can hide the widget.

1. Is the theme app embed actually turned on?

Go to Online Store → Themes → Customize → App embeds and confirm Caro Chat Widget is toggled on and saved. This is the single most common cause — see Installing the chat widget on your storefront.

2. Is the agent Active?

Check Apps → Caro → Settings → Agent identity → Status. If it's set to Inactive or Draft, the widget won't respond even if the embed itself is on. See Pausing and resuming your agent.

3. Is a domain restriction blocking it?

If you've set a value under Settings → Domain restrictions, the widget only loads on listed domains. Check you're testing on a domain that's actually included — or that the field is empty (allowing any domain) if you haven't deliberately restricted it. See Domain restrictions and spam protection.

4. Is Page visibility limiting where it shows?

Check Widget design → Behavior → Page visibility. If Show widget on has been narrowed from All pages to a specific subset, the widget simply won't appear on pages outside that set. See Behavior: replies, animations, memory, and page visibility.

5. Confirm with the Dashboard's own check

The Dashboard's Storefront widget row only shows "Live on your store" after a real page load confirms it — if it's stuck on not-detected after fixing the above, visit your storefront directly to trigger a fresh check.

Still stuck?

See Getting help when something's wrong.