Shopify chatbot embed
Install the chatbot launcher on a Shopify storefront by adding the script to the active theme.
Shopify
Before you start
Best for
Online stores that need product help, shipping answers, returns guidance, order policy answers, and lead capture.
Install location
Add the script near the closing body tag in layout/theme.liquid. Duplicate the theme before editing if the store is live.
Install
Install steps
- 1Copy the widget snippetOpen the chatbot Embed page and copy the final script.
- 2Duplicate the themeIn Shopify admin, duplicate the live theme so you can test the script before it reaches shoppers.
- 3Edit theme codeOpen the theme code editor, find layout/theme.liquid, and paste the script before the closing body tag.
- 4Preview and publishSave the theme, preview the storefront, then publish or copy the change to the live theme when verified.
Access
Domains
Add the store custom domain.
Add the myshopify.com domain if you test through that URL.
Headless storefronts should allow the public storefront domain, not the admin domain.
Verify
Verify
Do not install the visible chat widget as a custom pixel. Pixels are for event tracking and may run in a restricted sandbox.
Theme scripts usually do not appear on checkout pages. Verify storefront pages such as home, product, collection, and cart.
Theme updates can replace manual code edits, so keep a note of where the snippet was added.
Troubleshoot
Shopify troubleshooting
If the launcher does not appear, confirm the chatbot is published, the plan and credits are active, and the exact live hostname is allowed.
If the widget loads in preview but not production, check whether the builder preview URL and the live custom domain are different hostnames.
If the page has a content security policy, allow the OrhanAI app URL and widget requests before retesting.
If the launcher appears twice, remove duplicate snippets from theme files, site settings, and tag managers.
If mobile layout feels crowded, adjust widget position and test the most important conversion pages first.
If these checks pass and the widget still does not load, compare the installed snippet with the current Embed page and review widget setup.