Skip to main content
Looking for the Onsite Chat Widget instead? Check out the Onsite Widget installation guide.
The WhatsApp bubble is a floating button on your store. A shopper clicks it and starts a WhatsApp conversation with your AI Shopping Assistant. You install it once, from the Shopify theme editor. After that, TextYess controls the bubble: every change you save in the dashboard goes live on your store. You never paste or update code.
1

Switch on the TextYess app embed

In the Shopify theme editor, open App embeds from the left sidebar. Turn on TextYess, then click Save.
In TextYess, the Store visibility card on the bubble page has a Turn it on in Shopify button. It opens the theme editor on the TextYess app embed.
This is the same app embed that shows the TextYess pop-up and the Onsite Widget. If it is already on, skip this step. Each widget shows only when you switch it on in TextYess, so the app embed never shows a widget that you did not set up.
2

Customize your bubble

In TextYess, open Growth Tool Kit in the menu. On the WhatsApp chat bubble card, click Set up the bubble. You can also open the bubble in Agents → WhatsApp Agent → Appearance.Set the colors, the position and the texts, then click Save.
3

Switch the bubble on for your store

The first card on the bubble page is Store visibility. It shows if the bubble is Live or Hidden on your store, and if the app embed is active in your theme.Turn on Show the bubble on my store. The bubble shows on your store at the next page load. Turn it off at any time to hide the bubble again, with no theme edit.
Saving the look of the bubble never changes store visibility. Only this switch does.
Congratulations, you are live!

When the app embed is off

TextYess reads the home page of your store about once an hour. This check shows if the TextYess app embed is on in your published theme. If the app embed is off, the Store visibility card shows a warning with the name of your published theme. This often happens after you publish a copy of a theme.
  1. On the warning, click Turn it on in Shopify. The theme editor opens on the App embeds drawer of your published theme.
  2. Turn on TextYess, then click Save.
  3. Go back to the Store visibility card and click Check again.

Already installed with a pasted code snippet?

Earlier versions of TextYess asked you to paste a <textyess-bubble-widget> code snippet into theme.liquid. If your store still has one, your store never shows two bubbles: the pasted snippet wins, and the app embed does not add a second bubble. The Store visibility switch does not apply to a pasted snippet. To control the bubble from TextYess:
  1. Switch on the app embed (step 1 above).
  2. Turn on Show the bubble on my store (step 3 above).
  3. Remove the old snippet from your theme. See Remove the chat bubble code from a Shopify theme.