Skip to main content
Looking for the WhatsApp Bubble instead? Check out the WhatsApp Bubble installation guide.
The Onsite Widget is a powerful AI Shopping Assistant that runs directly on your website. It differs from the WhatsApp bubble by providing:
  • Full chat experience in a centered window or a side panel
  • Product carousel with variant selection
  • Persistent conversations across page navigation
  • Customizable appearance with colors, texts, and positioning
1

Customize your widget appearance

In TextYess, open Agents → Onsite Agent, select the Appearance tab, and personalize your widget.You can customize:
  • Colors: Main Color and Text Color
  • Text: Badge Text, Dialog Title and Welcome Message
  • Position: Right Center, Bottom Right, Bottom Center or Bottom Left
  • Display: centered modal or side panel
  • Popular Questions: up to 3 suggested questions for customers to ask
The widget loads these settings from TextYess every time your store renders. You install the code once; every later change you save publishes automatically.
2

Switch the widget on for your store

The first card of the Appearance page is Store visibility. The widget stays Hidden on your site until you turn this switch on, even after you install the code below. Publishing your settings never changes it.Once the snippet is installed, the card also tells you whether it is loading on your site.
3

Get the code snippet

The Widget installation card on the Appearance tab shows the code snippet to insert into your WooCommerce theme. It carries no appearance settings, so it never changes after a save. Before you paste it, add show_add_to_cart="false" to the <textyess-ai-widget> tag (see the warning below).
The code will look something like this:
Keep install="managed" in the tag. It tells the widget that TextYess manages it, so the Store visibility switch applies. A pasted snippet without it, from an earlier version of this guide, keeps rendering on its own and ignores the switch.
The onsite widget uses the <textyess-ai-widget> tag, which is different from the WhatsApp bubble widget (<textyess-bubble-widget>).
On WooCommerce (and any non-Shopify store) you must set show_add_to_cart="false". The Add to Cart action is currently supported on Shopify only, so leaving it enabled on WooCommerce will surface a button that cannot complete the purchase.
4

Go to Appearance > Editor

Once inside your store click on “Appearance” from the menu on the right.
From there click on “Editor”
5

Open the Patterns section

Once opened the editor, you should see something like this. You will need to click the “Patterns”
6

Open the Header pattern

Several patterns will be shown. You need to scroll down and select the one named “Header”
Once again, more than one header pattern may shown. Click the one in which you want to show the widget.
Before proceeding we strongly recommend that you duplicate the pattern that you want to edit. To do this, click on the three dots, then click on “Duplicate”.
7

Edit and save the code

Go to the bottom of the file and paste the code from the Get the code snippet step right before the last <!-- /wp:group -->
Once you have edited the code, click save in the upper right corner.
Congratulations, we are live!

Customization Options

All colors, texts, position, the bubble image, and suggested questions are configured on the Appearance tab of Agents → Onsite Agent in TextYess. Published changes go to your store automatically — you never edit the snippet again. Two options are set as attributes on the <textyess-ai-widget> tag itself:

Language

E-commerce

Example