—SETUP GUIDE

Web widget setup

Set the appearance, add the embed code to your site and test. The widget is a free bonus channel.

Time 6 min Steps 5 Read 5 min read Setup
01 Open the widget screen02 Set the appearance03 Add the embed code04 Test05 Trusted domains (optional)

Step 1 · Open the widget screen · 1 min

Where to click: Left menu → Widget.

What to enter: Nothing on this step.

What you should see: Cards for Embed code, Identity, Images and colours, Layout and behaviour, Welcome flow and Live preview, with a Save widget settings button at the bottom right.

If you get stuck: If you see "No assistant is linked to the widget channel — assign one from the Connections screen.", assign your assistant to the website chat channel under Connections.

Step 2 · Set the appearance · 2 min

Where to click: The Identity, Images and colours and Layout and behaviour cards.

What to enter (the main fields):

  • Title: the chat window heading. Examples by sector: Smile Support (dental clinic), Metalpar Technical Support (manufacturer/industry), Barber Booking (service business).
  • Use assistant name: writes the linked assistant's name into the title.
  • Welcome message: Hello! How can I help you?
  • Bubble text: Hello! Let me help you — Bubble label: Live Support.
  • Avatar URL and header image URL: images are supplied as a full URL; there is no upload.
  • Primary colour / secondary colour / accent colour: for example #1a7ec2.
  • Position: bottom right or bottom left; opening animation: slide up, fade or no animation.
  • Full screen on mobile, unread badge, sound on a new reply: switch each one on or off.

The Live preview on the right shows how it will look before you save. When you are happy, press Save widget settings at the bottom right.

What you should see: An "All changes saved" indicator.

If you get stuck: The bubble and icon do not move; only the form that opens scrolls. For a colour you may see "… must be in #rrggbb format."; for an image, "… must start with http:// or https://."

Step 3 · Add the embed code to your site · 2 min

Where to click: Embed code card → Copy code.

What to enter: The code is this line (your organisation ID is filled in automatically by Copy code):

<script src="https://api.yanitlabs.com/platform/widget.latest.js" data-tenant="YOUR_ORGANISATION_ID"></script>

Add this line to your site just before the </body> tag: "Add this line before your site's </body> tag. No other change is needed." On platforms such as WordPress, Shopify, ikas and Ticimax, use the "custom code / footer code" field. The page also shows it as Organisation ID:.

What you should see: The Copy code button changes to Copied. When you open your site, the chat bubble appears in the corner.

If you get stuck:

  • If "Could not copy; select the code and copy it manually." appears, select and copy the code by hand.
  • Place the code before </body>. Older help texts may say <head>; the current instruction is before </body>.
  • You do not need to re-add the code after changing the name, image or colours; widget.latest.js always serves the current version. If browser caching causes trouble, hard-refresh the page.

Step 4 · Test it · 1 min

Where to click: Open your site → the chat bubble in the corner.

What to enter: Send a question such as How much is an implant? (dental clinic) · Can I get a quote for this product? (manufacturer/industry) · Can I book an appointment? (service business).

What you should see: The assistant's answer coming from your knowledge base. (The Test assistant screen on Overview does not use the knowledge base; use this step for a real test.)

If you get stuck: If no answer arrives, make sure the document is Ready in the Knowledge Center and that an assistant is assigned to the website chat channel under Connections. Check that you added the code before </body>.

Step 5 · Trusted domains (optional)

Where to click: The Trusted domains card.

What to enter: The sites where the widget may run. Example: site.com or the wildcard *.site.com. Add them with Add domain; up to 20 domains are stored.

What you should see: The addresses you added in the list.

If you get stuck: If you see "Invalid domain: "…". Example: site.com or *.site.com", correct the address. If you leave this empty, the widget runs on every site — adding your own domain is recommended for security.

If you get stuck

Message you see What it means / what to do
Widget settings could not be saved. Refresh the page and save again.
No assistant is linked to the widget channel — assign one from the Connections screen. Assign an assistant to the website chat channel under Connections.
Invalid domain: "…". Example: site.com or *.site.com Correct the trusted domain.
… must start with http:// or https://. The image address must be a full URL.
… must be in #rrggbb format. The colour code must start with # and have six digits.
Avatar height must be a number between 0 and 400 (empty = default). Set the number between 0 and 400.
This rule has no conditions and will not be saved. Add at least one condition (time, scroll or URL). Add at least one condition to the trigger rule.
Could not copy; select the code and copy it manually. Copy the code manually.
The bubble does not appear on the site Add the code before </body>, hard-refresh the page and disable ad blockers.

Checklist

  • Open the widget screen
  • Set the appearance
  • Add the embed code
  • Test
  • Trusted domains (optional)

The source of this guide had 3 screenshots; they were not moved to the new site. The text is preserved; images will be added in a separate step.

+RELATED POSTS

Posts on this topic

Posts from the same topic cluster that complete this page. All blog posts.

Let’s set it up together.

Try free for 14 days, no credit card. Setup support included; cancel anytime.

Call Start 14-day trial