Skip to content
Back to all support articles
Getting started widgetscriptinstallwebsite

Install the widget

The widget is two script tags. One sets the configuration, one loads Mikabot. You paste them once, in a template that runs on every page.

Step 1: Copy your snippet

  1. Open your chatbot
  2. Go to Settings → Site info
  3. Scroll to Install widget
  4. Pick your platform: Static site, WordPress, Next.js, Magento, or More
  5. Click the copy button

Your snippet already contains your chatbot key and default language. Copy it — do not retype it from an example.

Step 2: What the snippet looks like

<script>
window.MIKADO_CHATBOT_CONFIG = {
    "domain": "https://mikabot.studio-mikado.be",
    "store_id": "st_your_chatbot_key",
    "language": "en"
};
</script>
<script src="https://mikabot.studio-mikado.be/js/mikabot-init.js"></script>
KeyWhat it does
domainThe Mikabot app the widget talks to. Pre-filled — leave it alone.
store_idYour chatbot key. Identifies which chatbot and catalog to use.
languageThe starting language. Must be one of the languages you activated.

Step 3: Paste it in the right place

PlatformWhere
Static siteIn the shared footer template, just before </body>
WordPressA header/footer scripts plugin, in the footer field
MagentoContent → Design → Configuration → your store view → Footer → Miscellaneous HTML
Next.jsA client component using next/script, rendered near the end of <body> in app/layout.tsx
Anything elseThe global custom-HTML or theme-scripts area that loads on every page

Step 4: Verify

  1. Publish the change and clear your theme, plugin, and CDN caches
  2. Open your site in a private window
  3. Check a product page and a non-product page, on desktop and on mobile
  4. Send a test message and confirm the reply arrives

If nothing appears, check that the chatbot is enabled: Settings → Chatbot settings → Active.

Common mistakes

  • The snippet is installed twice — once globally and once in a page template. Remove one; the loader will not start twice, but duplicate config blocks can fight over the language.
  • Only the second script tag was copied. Without MIKADO_CHATBOT_CONFIG the widget has no chatbot key and stays silent.
  • A cache still serves the old page. Clear the theme cache, the plugin cache, and the CDN, in that order.
  • The domain in Site info does not match the live site. Update Settings → Site info → Domain so it matches exactly.
  • The chatbot is set to inactive. Nothing renders at all.

Next steps

Related articles

Contact us

Our support team is ready to give you fast, personal help when you need it.