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
- Open your chatbot
- Go to Settings → Site info
- Scroll to Install widget
- Pick your platform: Static site, WordPress, Next.js, Magento, or More
- 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>
| Key | What it does |
|---|---|
domain | The Mikabot app the widget talks to. Pre-filled — leave it alone. |
store_id | Your chatbot key. Identifies which chatbot and catalog to use. |
language | The starting language. Must be one of the languages you activated. |
Step 3: Paste it in the right place
| Platform | Where |
|---|---|
| Static site | In the shared footer template, just before </body> |
| WordPress | A header/footer scripts plugin, in the footer field |
| Magento | Content → Design → Configuration → your store view → Footer → Miscellaneous HTML |
| Next.js | A client component using next/script, rendered near the end of <body> in app/layout.tsx |
| Anything else | The global custom-HTML or theme-scripts area that loads on every page |
Step 4: Verify
- Publish the change and clear your theme, plugin, and CDN caches
- Open your site in a private window
- Check a product page and a non-product page, on desktop and on mobile
- 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_CONFIGthe 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
- Advanced widget placement — inline containers, tag managers, and single-page apps
- Appearance and branding — colours, avatar, bot name
- Troubleshooting — when the widget still will not show
Related articles
Account setup
Create your Mikabot account, verify your email, and find your way around the dashboard.
Create your first chatbot
Walk through the five-step setup wizard and get a working chatbot in minutes.
Advanced widget placement
Embed the chat inline, load it through a tag manager, or run it in a single-page app.
Contact us
Our support team is ready to give you fast, personal help when you need it.