Customizing the widget

The install snippet only carries your data-site-id. Everything about how the widget looks and behaves is configured in the dashboard — the widget fetches its settings at runtime, so you can change them without touching your site’s code.

Configured in the dashboard

Setting	Options
Accent color	Any hex color (default black).
Title	The panel header text (default “Ask us anything”).
Welcome message	First message shown when the widget opens.
Position	`bottom-right` or `bottom-left`.
Avatar	Your brand or agent image, shown in the header and beside human replies.
AI avatar	A separate glyph for the assistant: orb (default), sparkle, bot, or twinkle.
Launcher	Icon (13 options, see below), an optional label (≤30 chars), and whether to show it.
Suggested questions	Starter questions, shown in your order; 3 per visit, rotating when there are more.
Floating messages	Up to 5 short bubbles that appear near the launcher (see below).
Contact capture	Ask visitors for name / email, and when to ask.
Ratings	Per-answer satisfaction (thumbs) and end-of-chat rating (5 stars or 5 emojis).
Human handoff	Turn handoff on/off, require an online agent, and let the AI hand off on its own.
Email transcript	Let visitors email themselves the chat (on by default).
Hide “Powered by Yamidoo”	Available on Pro.

See the Widget reference for the full list with defaults.

Launcher icons

Pick one of 13 launcher icons: Yamidoo orb, Animated bubble, Outline (default), Outline with typing dots, Outline with Yamidoo y, Outline with spark, Solid, Solid with typing dots, Solid with Yamidoo y, Two bubbles, AI sparkle, AI smile, and Message box.

Floating messages

Floating messages are small bubbles that pop up next to the launcher before a visitor opens the chat. Add up to 5 (≤200 characters each), set the delay (3 seconds by default), and choose how often they show: once per visit, on every page, or only once. You can also show them on mobile (on by default) or only while an agent is online (off by default).

When clicked decides what a click on a bubble does:

Send it as a question (default): the chat opens and the text is sent as the visitor’s message. Write these as questions a visitor would ask, like “Do you ship internationally?”, so the assistant answers right away.
Put it in the message box: the chat opens with the text in the message box, not sent. The visitor can edit it or type their own question. Use this for invitations like “Questions? Ask us anything”.

Language

On Starter and up, Widget language switches the widget’s own text — the message placeholder, “Talk to a human”, the chat menu, contact prompts and system notices — to one of 14 languages: Danish, Dutch, English, French, German, Italian, Polish, Portuguese (Brazil), Romanian, Russian, Spanish, Swedish, Turkish and Ukrainian. Your title, welcome message, suggested questions and floating messages stay exactly as you wrote them. The AI’s replies are a separate setting under Behavior: by default it answers in whatever language the visitor writes in.

What visitors get

Without any configuration, the chat also offers visitors Recent chats (past conversations with a human reply, reopenable from the chat menu), End chat, Send transcript (by email; asks for an address if none is on file), file uploads on paid plans (10 MB per file, 20 per hour), and a typing indicator while an agent is writing.

Once loaded, the widget exposes a global yamidoo() function you can call to open, close, or drive it:

<script>
  yamidoo('open');            // open the chat
  yamidoo('close');           // close it
  yamidoo('ask', 'Do you offer refunds?'); // open and send a question
</script>

Open from your own button — no JavaScript

Add a data-yamidoo attribute to any element:

<button data-yamidoo="open">Chat with us</button>

Supported values are open, close, and toggle.

Identify a signed-in user

<script>
  yamidoo('identify', { name: 'Jane Doe', email: 'jane@example.com' });
</script>