Get it live
Install Adoomi on Shopify
When you finish, a chat bubble sits on the storefront pages that use your theme.
Before you start
- Your bot's Status is set to active How to check
- Your shop's address is in the bot's Allowed domains (comma-separated) box How to check
- You can edit theme code in your Shopify admin
About 5 minutes. You’ll do three things:
- copy your snippet
- paste it into theme.liquid
- save and check the bubble
There is no Adoomi app in the Shopify App Store, so there is no theme app embed to switch on. You paste one line of code into theme.liquid, the layout your storefront pages share. Every page built on that layout then loads the bubble.
Copy the snippet and paste it into your theme
In the bot sidebar, under Go live, click Install.
Under Install code, click the Shopify tab.
All the platform tabs hand you the same snippet. Only the paste spot changes.
In the Embed code block, click Copy.
The button reads Copied for a couple of seconds.
In your Shopify admin, go to Online Store › Themes.
Open Edit code for the active theme.
The active theme is the one at the top, marked as live. Editing any other theme changes nothing for shoppers.
In theme.liquid, paste the snippet just before the closing </body> tag.
Save the file.
Shoppers get the bubble on the next page load.
If it didn’t work
The chat bubble isn't on my shop
- Check
- Open your shop, right-click the page and choose View page source. Search that source for widget.js.
- Fix
- If widget.js is missing, the snippet went into a theme nobody sees. Go back to Online Store › Themes, check which theme is live, then paste the line into that theme's theme.liquid and save.
- Resolved when
- The bubble appears when the page loads.
The bubble vanished after I changed theme
- Check
- Each theme carries its own copy of theme.liquid. A new theme has no Adoomi line in it.
- Fix
- Repeat steps 4 to 7 on the theme that is now live.
- Resolved when
- The bubble is back on your shop's pages.
The bubble is there, but every message fails
- Check
- Open the bot's General settings and read the Allowed domains (comma-separated) box. The address in your browser bar has to be covered by it.
- Fix
- Type your shop's domain in, click Save, then reload. Shopify also serves your shop at yourshop.myshopify.com, so add that too if you test there.
- Resolved when
- The bot answers your test question.
The Install page says Bot not ready to embed yet.
- Check
- You see that when the bot is not active, or when no domain is allowed yet.
- Fix
- Open the bot's General settings. Set Status to active, put your domain in Allowed domains (comma-separated), then click Save. Reload the Install page. If the message stays, email hello@adoomi.ai and tell us which bot it is.
- Resolved when
- The Install code block and its platform tabs appear.
What this can’t do
- There is no Adoomi app in the Shopify App Store. The install is one line of code in theme.liquid.
- The line lives in one theme. Publish a different theme and the line is not in it — paste it again.
- Your shop answers at two addresses. Add yourshop.myshopify.com to Allowed domains (comma-separated) as well if you test on it.
- theme.liquid covers the whole storefront. To keep the bubble off certain pages, use Hide on these pages under Where the widget appears on the bot's Appearance page.
- The Live on your site pill records your first install only. On a second site it already reads that way, so check that site's own bubble instead.