Skip to main content

How to Set Up and Publish Chat Bubble (AI Shopper)

Written by Mikaela Lasig

Chat Bubble adds a floating launcher that lets shoppers open the AI Shopper assistant from anywhere on the site. This helps merchants offer instant product guidance, reduce friction, and make the assistant easy to access across the storefront. Chat Bubble is a paid AI Shopper entry point, so merchants need a paid Shopper plan to publish it live.

How to Set Up

  1. Go to Customer Agent → Features → Chat Bubble

  2. Use the Test Agent tab to review how the shopper assistant responds.

  3. In Style, customize the bubble:

    • Upload a logo, or use the default icon style

    • Set background and icon colors

    • Choose the bubble position

  4. In Content → Settings, configure visibility rules such as blocked collections and included templates.

  5. Review the preview and save your changes.

How to Publish

Shopify

  1. Click Publish.

  2. If prompted, enable the Tolstoy app embed in Shopify. You should see a notification 'Chat Bubble widget published'

  3. Verify that the Chat Bubble appears on the storefront and opens the assistant correctly.

Unlike block-based entry points, Chat Bubble does not need to be added to the product page template. It relies on the app embed being enabled.
​

Non-Shopify

  1. Open the publish flow.

  2. Copy the Chat Bubble embed code.

  3. Paste it into your site where the widget should load.

  4. Publish the widget.

  5. Test it on the live site.

Best Practices

  • Place the bubble in a corner that does not compete with other sticky elements like chat, loyalty, or accessibility widgets.

  • Use brand-consistent colors so the launcher feels native to the storefront.

  • Test the bubble on mobile and desktop before launch to make sure it does not cover key page actions.

  • Keep your shopper assistant profile and knowledge settings up to date, since the bubble is only the launcher for that broader assistant experience.

Troubleshooting / FAQs

Why can't I publish Chat Bubble?
Chat Bubble requires a paid Shopper plan to go live.

Why is the bubble not showing on Shopify?
The Tolstoy app embed may still be disabled in the active Shopify theme.

Why does the status say Paused?
The widget is published, but the store is not currently billable for Shopper usage.

Does Chat Bubble need a Shopify block?
No. Chat Bubble uses the app embed rather than a product-page block.

Can I change how the assistant behaves from this page?
You can test and launch the bubble here, but the assistant's profile, chat behavior, tools, and knowledge are managed globally in AI Shopper settings.

Did this answer your question?