By industry
Car dealershipsCar rentalDetailers & valetersGarages & MOT centresFashion retailersFurniture storesPet storesJewellersPlumbersElectriciansHVAC & heating engineersCleanersLandscapers & gardenersRoofersHotels & guest housesRestaurantsCafésGyms & wellness studiosTour operatorsEstate agentsLetting agentsProperty managementServiced accommodationAccountantsLaw firmsInsurance brokersMortgage brokersRecruitment agenciesPrivate schoolsNurseriesChildren's activity clubsTraining providersTutoring centresCharitiesMuseums & attractionsReligious & community centresSports clubs
All guides(35)

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:

  1. copy your snippet
  2. paste it into theme.liquid
  3. 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

  1. In the bot sidebar, under Go live, click Install.

  2. Under Install code, click the Shopify tab.

    All the platform tabs hand you the same snippet. Only the paste spot changes.

  3. In the Embed code block, click Copy.

    The button reads Copied for a couple of seconds.

  4. In your Shopify admin, go to Online Store › Themes.

  5. 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.

  6. In theme.liquid, paste the snippet just before the closing </body> tag.

  7. 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.

Next steps