Shopify guide Install ToastUp on Shopify
in 5 minutes
Copy your ToastUp snippet, paste it into your Shopify theme's theme.liquid file, and boost conversions across your store immediately.
<script async src="https://toastup.co/widget.v1.js" data-site="YOUR_SITE_KEY"></script>
Make sure
these are ready.
Shopify installation is extremely clean and doesn't affect your store performance when these requirements are ready.
- 🔐Shopify Admin accessAccess to your Shopify store admin panel.
- 🌐Connected domainA published Shopify store connected to the same domain you add in ToastUp.
- 📋Ready snippetYour ToastUp snippet copied from Dashboard -> Install snippet.
- 🧩Edit theme permissionPermission to edit theme files (specifically theme.liquid) in your Shopify store.
- 🚀Step 1Copy your ToastUp snippetIn ToastUp, open Dashboard -> Install snippet, add your Shopify domain, then copy the script snippet.
- 🛒Step 2Open Shopify Themes settingsLog in to your Shopify Admin, and navigate to Online Store -> Themes in the left sidebar.
- 🛠️Step 3Go to Theme Code EditorFind your active theme, click the three dots (...) button next to the Customize button, and click Edit code.
- 📂Step 4Open theme.liquid fileIn the left file navigator under the Layout folder, click to open theme.liquid.
- 📌Step 5Paste before closing head tagScroll down to find the closing </head> tag, paste your full ToastUp snippet directly before it, and click Save in the top-right.
How to check
that it works.
After saving your Shopify template changes, perform this quick validation to confirm the installation is active.
- 🕵️Open your live Shopify storefront in a new incognito window.
- 🔎View page source and search for widget.v1.js.
- 🔑Confirm the snippet contains your data-site key from ToastUp.
- 📣Confirm the toast is published and assigned to this Shopify store website.
- 🎯Test on a storefront URL and device that match the targeting rules.
Toast Not Showing?
Most Shopify display concerns are linked to theme updates, storefront locks, or checkout limits. Here is how to address them:
Snippet not found in page source
Make sure you pasted the code inside the active theme's theme.liquid file and saved the changes. If you are using a draft theme, you will need to publish it first.
Password-protected storefront
If your Shopify store is locked behind a password page, the script might not load or run until visitors enter the password. Test on the actual store pages after unlock.
Checkout pages exclusion
Shopify restricts custom head scripts on the standard checkout pages for security. Your toasts will appear on all catalog, collection, and product pages.
Domain mismatch
Ensure the domain added in ToastUp matches your live storefront URL (including subdomains or the .myshopify.com developer preview domain if testing).
Frequently Asked Questions
Find the information you need in a snap. Complete answers to make your experience easier.
Where exactly do I paste the ToastUp snippet in Shopify?+
Open your Shopify admin, go to Online Store -> Themes -> Edit Code, open theme.liquid under the Layout folder, and paste it directly before the closing </head> tag.
Will updating my Shopify theme delete the ToastUp snippet?+
Yes. If you switch to a completely new theme or download a major theme update that replaces your layout files, you will need to paste the snippet into the new theme's theme.liquid file again.
Do I need a Shopify app to install ToastUp?+
No! ToastUp installs with a simple copy-paste script tag. This keeps your store incredibly fast and avoids installing heavy Shopify apps.
Why is my toast not showing on Shopify?+
Make sure the script is present in page source, your toast is published in ToastUp, and the targeting settings (like device or page paths) match the URL you are visiting.
Ready to add ToastUp to Shopify?
Create your account, copy one snippet and launch your first storefront toast.
Start Free with ToastUpWant the full tour first? See every ToastUp feature or compare plans & pricing.