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 with a centered modal dialog
  • Product carousel with variant selection
  • Persistent conversations across page navigation
  • Customizable appearance with colors, banners, and positioning
1

Customize your widget appearance

Click on the “Growth tool kit” section of the menu. From there select the Onsite Widget integration block and personalize your widget.You can customize:
  • Colors: Background, bubble, and icon colors
  • Text: Dialog title, welcome message, and bubble text
  • Position: Bottom-right corner or right-center of the screen
  • Banner image: Display a promotional image at the top of the chat
  • Popular questions: Suggested questions for customers to ask
2

Get the code snippet

From there you will find the code snippet to insert into your WooCommerce theme.
The code will look something like this:
<script
  type="module"
  src="https://cdn.textyess.com/v2/textyess-widget-components/textyess-widget-components.esm.js"
  defer
></script>
<textyess-ai-widget
  organization_id="your_organization_id"
  language="en"
/>
The onsite widget uses the <textyess-ai-widget> tag, which is different from the WhatsApp bubble widget (<textyess-bubble-widget>).
3

Go to Appearance > Editor

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

Open the Patterns section

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

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”.
6

Edit and save the code

Go to the bottom of the file and paste the code from step 2 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

You can customize the onsite widget by adding attributes to the <textyess-ai-widget> tag:

​
Colors

AttributeDescriptionDefault
background_colorChat window background color#7f1d1d
bubble_colorFloating bubble color#7f1d1d
bubble_content_colorText/icon color inside bubble#ffffff
icon_colorIcon color in UI elements#ffffff

​
Position & Appearance

AttributeDescriptionDefault
bubble_positionPosition of the bubble: bottom-right or right-centerright-center
image_banner_urlURL of banner image shown at top of chat-
image_fitHow banner image scales: contain or covercover

​
Text & Content

AttributeDescriptionDefault
dialog_titleTitle shown in the chat window header-
welcome_messageInitial greeting message-
bubble_textText on the floating action bubble-
badge_textBadge text (e.g., “NEW”)-
popular_questionsSuggested questions (comma-separated)-

​
Language

AttributeDescriptionDefault
languageLanguage: en (English) or it (Italian)it

​
E-commerce

AttributeDescriptionDefault
show_add_to_cartShow “Add to Cart” buttons for productstrue

​
Example with customization

<script
  type="module"
  src="https://cdn.textyess.com/v2/textyess-widget-components/textyess-widget-components.esm.js"
  defer
></script>
<textyess-ai-widget
  organization_id="your_organization_id"
  language="en"
  dialog_title="Shopping Assistant"
  welcome_message="Hi! How can I help you today?"
  bubble_text="Need help?"
  background_color="#1e40af"
  bubble_color="#1e40af"
  bubble_position="bottom-right"
  show_add_to_cart="true"
/>