Installation

Get the Yamidoo widget live on your site in a couple of minutes.

Preview before you install

Not sure what Yamidoo would say about your site? Run the Support Readiness Scan. It reads up to 14 pages of any site and shows the questions visitors would ask, answered from its content, in about ten seconds.

1. Open the Installation page of your project in the Yamidoo dashboard. It has three tabs, one per placement: Floating chat, On the page and iframe. Each shows where the chat ends up and gives you the code with your site ID already filled in. The floating chat is the default, and what the steps below install.

2. Add the snippet just before the closing </body> tag on every page where you want the widget to appear.

   HTML

   <script
     src="https://app.yamidoo.ai/widget.js"
     data-site-id="YOUR_SITE_ID"
     async
   ></script>

   Next.js

   app/layout.tsx

   import Script from 'next/script';
   
   export default function RootLayout({ children }) {
     return (
       <html lang="en">
         <body>
           {children}
           <Script
             src="https://app.yamidoo.ai/widget.js"
             data-site-id="YOUR_SITE_ID"
             strategy="afterInteractive"
           />
         </body>
       </html>
     );
   }

   WordPress

   No code. The plugin stays clear of caching and script-delay plugins (WP Rocket, LiteSpeed, Perfmatters, Autoptimize, SiteGround Optimizer) on its own.

   1. In wp-admin go to Plugins → Add New Plugin, search for Yamidoo, then Install and Activate. It is also listed at wordpress.org/plugins/yamidoo.
   2. Open Settings → Yamidoo and click Connect to Yamidoo. Sign in or create a free account, confirm, and you’re sent back with the site linked and indexing started. Prefer to do it by hand? Paste your Site ID into the same screen instead — you’ll find it in the dashboard under your project → Integrations → WordPress.

   The widget appears on every page right away. Logged-in WordPress users are identified to your team by name and email automatically. Running Easy Digital Downloads or WooCommerce? The plugin can also show customer data — orders, licenses and subscriptions — to your team, and to the AI if you opt in.

3. Deploy and open your site — the widget appears in the bottom corner.

Tip

Replace YOUR_SITE_ID with the ID from your dashboard. It’s not a secret — it only identifies your site. Keep the snippet in a shared layout so it loads on every page.

Put the chat on the page instead of in a bubble

By default the widget is a floating bubble in the corner. It can also render as a normal block in your layout — a support page, a help center, a sidebar. These are the On the page and iframe tabs on the Installation page. Both drop the launcher and keep everything else: answers from your content, file attachments, and human handoff.

On the page

Point the script at an element with data-mount and the chat fills it: the full width of its container, at the height you give it. Add a max-width if you want it narrower. Use this anywhere you can add a script.

<div id="yamidoo-chat" style="height:600px"></div>
<script
  src="https://app.yamidoo.ai/widget.js"
  data-site-id="YOUR_SITE_ID"
  data-mount="#yamidoo-chat"
  async
></script>

iframe

For platforms that accept HTML but not scripts. It spans the full width by default; set the height yourself, since an iframe cannot resize itself to its content.

<iframe
  src="https://app.yamidoo.ai/embed/YOUR_SITE_ID"
  title="Chat"
  width="100%"
  height="600"
  frameborder="0"
  style="border:0;border-radius:12px"
></iframe>

Note

Prefer the in-page option when you have the choice. A framed chat can only see your site’s address, not the exact page, so the Live view shows https://yoursite.com/ for every visitor who uses it.

You can run both at once: an embedded chat on your support page and the floating bubble everywhere else.

Telling installs apart

Every new conversation records where it started: floating chat, on the page or iframe, plus the page of the first message. Analytics shows the split under Where chats start, and each conversation shows it under Session → Chat started from.

To compare individual installs, for example the chat on your contact page against the one in your help center, give each a label:

<script src="https://app.yamidoo.ai/widget.js" data-site-id="YOUR_SITE_ID"
        data-mount="#yamidoo-chat" data-placement="contact" async></script>

<iframe src="https://app.yamidoo.ai/embed/YOUR_SITE_ID?placement=help-center" …></iframe>

Labels are free text, up to 40 characters. Chats from before this was added (September 2026) have no placement.

Next steps

• Point Yamidoo at your content so it can answer — see Answering from your content.
• Set up human handoff for questions that need a person.
• Tune the widget’s look and behavior in Customizing the widget.