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
  • Shopify cart integration for seamless add-to-cart functionality
  • 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 Shopify 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 the Online store section

Once inside your store click on “Sales channels” from the menu on the right.
A pop-up will appear at the top. From there click on “Online store”
4

Open the Theme editor

Opening the theme editor is very simple. Just click on the three dots of the theme you want to update. Then click on “Edit code”.
Before proceeding we strongly recommend that you make backups of your current theme. To do this, click on the three dots, then click on “Duplicate” and/or “Download theme file.”
5

Edit the theme.liquid file

This might seem the scariest part for those without technical skills, but it is actually a very simple operation.
As a first thing you will notice that on the left side you have a bunch of files. Look for one called theme.liquid and click on it.
On the right, a file with codes will have opened for you. Don’t worry, you don’t need to know what it says. What you need to do now is scroll to the end of the file and look for the </body> tag
If you cannot find the tag press cmd + F on Mac or ctrl + F on Windows. Then type </body> to find the tag within the search.
Once you find the tag, paste the code snippet you generated from TextYess (see step “Get the code snippet”) right before the the </body> tag. Remember that if necessary you can create new lines by pressing the enter key in order to put space between the TextYess’s code snippet and the </body> tag.
Your code should 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"
/>

</body>
We are almost finished!
Now click the “Save” button in the upper right corner, then click the “Preview store” button to make sure the widget is displayed correctly.
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"
/>