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 Vosaire 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 → Vosaire: AI Chatbot & Sales → Account → 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.