How to add an AI chatbot to Shopify Hydrogen
On Shopify Hydrogen, a chat widget is installed through app/root.tsx, inside the document body. Applies on your next Oxygen deploy. None beyond your Shopify plan.
Where it goes
app/root.tsx, inside the document body
Availability: None beyond your Shopify plan.
Adding the chatbot to Shopify Hydrogen
- 1
Open app/root.tsx.
- 2
Add the script element inside <body>, after the <Scripts /> component.
- 3
Rebuild and deploy to Oxygen.
- 4
Applies on your next Oxygen deploy.
The snippet you paste
<script src="https://rubyrep.com/rubyrep.js" data-rubyrep="rr_your_public_key" defer></script>Your own key replaces rr_your_public_key — you get it after training RubyRep on your site.
Worth knowing on Shopify Hydrogen
Hydrogen sets a Content Security Policy by default — add the widget's origin to script-src and connect-src or it will be blocked.
Theme-level Shopify instructions do not apply to Hydrogen; this is a React app, not a Liquid theme.
Shopify Hydrogen questions
- Where does the code go on Shopify Hydrogen?
- app/root.tsx, inside the document body. Applies on your next Oxygen deploy.
- Do I need a paid Shopify Hydrogen plan?
- None beyond your Shopify plan.
- Will a Shopify Hydrogen update remove it?
- Hydrogen sets a Content Security Policy by default — add the widget's origin to script-src and connect-src or it will be blocked.
- Does it slow Shopify Hydrogen down?
- No measurable effect. The snippet is deferred, so it loads after your page has rendered, and the chat interface itself is only fetched when a visitor opens it.
Related
term
What is a website chatbot?
The term covers two very different things. Older chatbots follow scripts and break the moment a visitor phrases something unexpectedly. Modern ones retrieve from a business's own content and generate an answer, which handles arbitrary phrasing.
term
What is AI customer service?
AI customer service means answering customer questions with a language model rather than a person. The useful implementations are grounded in a specific business's own content; the poor ones let a general model improvise, which produces confident answers that are wrong.
guide
How to add an AI chatbot to your website
Adding an AI chatbot takes minutes. Making it answer correctly takes preparation. This covers what to check before you install anything, how installation actually works, and the three failure modes that make businesses take chatbots back down.
how-to
How to add FAQ schema on any website platform
Mark up your existing FAQ answers so search engines and AI assistants can quote them directly. The code is the same everywhere; where you paste it is not. This covers 35 platforms, 19 of which gate custom code behind a paid plan.
how-to
How to add live chat on any website platform
Put a real-time conversation route on every page of your site. The code is the same everywhere; where you paste it is not. This covers 35 platforms, 19 of which gate custom code behind a paid plan.
Get your snippet.
Enter your Shopify Hydrogen site and RubyRep reads it, builds your representative, and hands you the exact line to paste.
Using something else? See all platforms.