Shopify
Any Shopify theme, Online Store 2.0 included
The widget goes into your theme's layout file, so it loads on every storefront page at once.
Before you start
Checkout pages are not covered
Shopify does not run theme code on the checkout, so the widget appears everywhere except those pages. That is a Shopify restriction rather than a setting on our side.
Works on every Shopify plan.
Duplicate the theme first
Editing a live theme takes effect immediately. Online Store → Themes → … → Duplicate gives you something to roll back to.
Code to paste
<script>
(function () {
var s = document.createElement("script");
s.src = "https://prod2.readychatai.com/api/widget/js/";
s.async = true;
s.onload = function () {
ReadyChatAI.init({ apiKey: "YOUR_API_KEY", apiUrl: "https://prod2.readychatai.com" });
};
document.head.appendChild(s);
})();
</script>Steps
- In your Shopify admin, go to Online Store → Themes.
- On your live theme, open the … menu and choose Edit code.
- In the Layout folder, open
theme.liquid. - Scroll to the bottom of the file and paste the code immediately before the closing body tag.
- Click Save.
- Open your storefront in a new tab and refresh.
Replace YOUR_API_KEY with the key from your ReadyChatAI dashboard, under AI Bot, Configure, Website Widget.
The chat button is not showing up
Ordered by how often each one turns out to be the cause.
Your domain is not on the allowed list
In the widget's Settings tab, under Allowed Domains, mysite.com and www.mysite.com count as two different domains. Add both, plus any subdomain you use. An empty list allows every site.
The widget is switched off
The toggle at the top of the widget settings has to read Widget enabled. While it is off the script still loads, but nothing is drawn.
Your site is still serving a cached page
Caching plugins and your host's own cache keep serving the old HTML after you save. Purge every cache, then reload with a hard refresh.
A speed plugin is deferring the script
Options named Delay JavaScript execution, Defer JS or Combine JS break the loader. Add readychatai to the exclusion list of whichever plugin does the optimising.
Cloudflare Rocket Loader is rewriting the script
Rocket Loader defers scripts in a way that stops the widget's load callback from firing. Turn it off, or add a page rule that disables it for your site.
The page is HTTPS and the code says http
Browsers block that request outright and the console says so. The code we generate is already HTTPS, so this only happens when the snippet has been edited by hand.
A Content Security Policy is blocking us
If your site sends a Content-Security-Policy header, allow our domain in both script-src and connect-src. Your browser console names the directive that blocked the request.
An ad blocker is hiding the launcher
Some blockers hide chat widgets by default. Check in a private window with extensions disabled before reporting a problem.
Still stuck?
Send us your website address and the platform it runs on, and we will take a look.
Other platforms
- WordPressSelf-hosted WordPress, WooCommerce, Elementor and Divi
- WixPaid plan requiredWix and Wix Studio
- SquarespacePaid plan requiredSquarespace 7.0 and 7.1
- WebflowPaid plan requiredWebflow sites on a paid Site plan
- GoDaddyGoDaddy Websites + Marketing
- Google Tag ManagerAny site that already runs GTM
- Any website (HTML)Static sites, custom-built sites, and anything not listed above
What customers need
Customer Use Cases
Automate online sales through your online bot.
Online Sales
E-commerce automation
Enhance customer engagement by providing instant responses to inquiries.
Customer Support
24/7 automated assistance
Streamline appointment scheduling directly through your social media bot.
Appointment Booking
Automated scheduling
Increase customer retention with automatic intelligent replies to personalized follow-ups.
Customer Retention
Personalized messaging
Boost your marketing efforts by automating promotional messages.
Marketing Automation
Targeted promotions
Reduce response times with instant FAQs and product information.
Instant Information
FAQ automation
Automate online sales through your online bot.
Online Sales
E-commerce automation
Enhance customer engagement by providing instant responses to inquiries.
Customer Support
24/7 automated assistance
Streamline appointment scheduling directly through your social media bot.
Appointment Booking
Automated scheduling
Increase customer retention with automatic intelligent replies to personalized follow-ups.
Customer Retention
Personalized messaging
Boost your marketing efforts by automating promotional messages.
Marketing Automation
Targeted promotions
Reduce response times with instant FAQs and product information.
Instant Information
FAQ automation