Skip to main content
Docs menu

Docs / Getting Started

Installing the chat widget on your storefront

The widget isn't added through Caro's own app pages — it's installed as a theme app embed, the standard way Shopify apps add storefront elements.

The fastest way in

From the Dashboard, click Manage in theme editor on the Storefront widget row — this opens your theme editor with the App embeds panel already targeted at Caro. You can also get there manually via Online Store → Themes → Customize → app embeds icon (the grid icon in the top toolbar).

Theme editor's App embeds panel with the Caro Chat Widget toggle enabled and the live chat bubble visible in the storefront preview

Turning it on

  1. Open the App embeds panel (the grid-shaped icon next to the sections and theme-settings icons).
  2. Find Caro Chat Widget under Caro - AI Support Agent.
  3. Toggle it on.
  4. Click Save in the top-right of the theme editor.

Once enabled, the live preview immediately shows the chat launcher bubble in the corner of your storefront — exactly as customers will see it.

Confirming it's really live

The Dashboard's Storefront widget row doesn't just reflect whether you toggled the embed on — it says "Confirmed — a real visit to your storefront loaded the widget," meaning Caro has verified the widget actually rendered on a real page load, not just that the setting is enabled. If that row doesn't show "Live on your store" after you've saved the embed, visit your storefront directly (View my store) to trigger that confirmation.

Why this is a separate step from everything else in Caro

Every other Caro setting lives inside the app's own admin pages, but the storefront embed is theme-level by design — it's what lets you control exactly where in your theme's app-embed order the widget loads, same as any other Shopify app that adds a storefront element (a reviews widget, a live-chat tool, etc.).