Skip to main content
The easiest way to add homie AI to Shopify is the official homie Shopify app: install it and switch the widget on in the Shopify Theme Editor — one click, no code. If you’d rather not use the app, you can paste the embed script into your theme manually.
Before you start, make sure you have an assistant created on the platform and access to your Shopify admin.
1

Install the homie Shopify app

Open your assistant’s Publish area on the platform, choose Shopify, and select To the Shopify app (or install the homie app directly from the Shopify App Store). It installs with one click and needs no code changes.
2

Open the Theme Editor

Back on the platform, select Open theme editor to jump straight to your store’s Theme Editor.
3

Enable homie and enter your assistant ID

In the Theme Editor’s app embeds, turn on the homie embed, paste your assistant ID (copy it from the Publish area), and activate it.
4

Save

Click Save in the Theme Editor.
Refresh your store. The homie chat bubble appears in the bottom-right corner. Open it and send a test message.
Installing the app also connects your Shopify store, so your product catalog stays in sync and you can turn on conversion tracking. See the Shopify integration for the data and conversion side.

​
Alternative: paste the embed script

If you can’t or don’t want to use the Theme Editor, add the embed script to your theme manually.
1

Copy your embed script

Open your assistant on the platform, go to its Publish area, and copy the script. It already contains your chatbotId.
Platform Publish area showing the copyable Shopify script snippet
2

Open Themes in Shopify

In your Shopify admin, go to Online Store → Themes.
Shopify admin navigating to Online Store Themes
3

Edit your theme code

Open the ••• menu next to your live theme and choose Edit code.
Shopify theme menu with the Edit code action highlighted
4

Paste before the closing body tag and save

  1. In the sidebar, open layout/theme.liquid.
  2. Scroll to the bottom, just above the closing </body> tag.
  3. Paste the script you copied.
  4. Click Save.
theme.liquid with the homie script pasted before the closing body tag
theme.liquid
Adding platform="shopify" lets the widget forward Shopify market context (such as country and currency) to your assistant.

​
Troubleshooting

  • No bubble showing? Clear your cache or open the store in an incognito window.
  • Multiple themes? Enable homie (or add the script) on every theme you publish.
  • Need a different position or color? Adjust it on the platform under your assistant’s appearance settings.
For deeper configuration and methods, see the Client API.

​
Next steps

Shopify integration

Sync your product catalog and attribute purchases to conversations.

Client API

Configure the widget and call methods from your site.