WordPress guideInstall ToastUp on WordPress
in 5 minutes
The easiest way is to copy your ToastUp snippet, paste it into the WordPress site header with a small plugin, then publish a toast.
SNIPPET
<script async src="https://toastup.co/widget.v1.js" data-site="YOUR_SITE_KEY"></script>
One snippet. More visible campaigns.
Capture more leads
Turn traffic into subscribers, trial users or booked calls.
Promote offers fast
Announce coupons, launches and seasonal campaigns instantly.
Measure every toast
See what gets attention without adding another heavy plugin.
You Only Need
Four Things.
If these are ready, you can move from setup to your first live conversion toast in minutes.
- 🔐Admin accessAccess to your WordPress admin panel.
- 🌐Connected domainA ToastUp account with your WordPress domain added.
- 📋Ready snippetYour ToastUp snippet copied from Dashboard -> Install snippet.
- 🧩Install permissionPermission to install plugins or edit theme files in WordPress.
- 🚀Step 1Copy your ToastUp snippetIn ToastUp, open Dashboard -> Install snippet, add your WordPress domain, then copy the script snippet.
- 🧩Step 2Install a header code pluginIn WordPress, open Plugins -> Add New and install a header code plugin such as WPCode or Insert Headers and Footers.
- 🧠Step 3Create a Head scriptOpen the plugin settings and create a new Header / Head script.
- 📌Step 4Paste the full snippetPaste the full ToastUp snippet into the Header / Head field. Do not paste only the site key.
- ⚡Step 5Save and clear cacheSave or activate the snippet, then clear cache if your WordPress site uses a cache plugin or CDN.
- 🎉Step 6Publish your first toastGo back to ToastUp, create or open a toast, select this WordPress website, and publish it.
- 📋Step 1Copy snippetIn ToastUp, copy the snippet from Dashboard -> Install snippet.
- 🛠️Step 2Open theme editorIn WordPress, open Appearance -> Theme File Editor.
- 🛡️Step 3Use a child themeSelect your active child theme if you have one, then open header.php.
- 📍Step 4Place before </head>Find the closing </head> tag and paste the full ToastUp snippet directly before it.
- ✅Step 5Update and publishUpdate the file, clear cache, then publish a toast for this website in ToastUp.
How to Check
That It Works.
After saving the WordPress snippet, run through this quick checklist before assuming something is broken.
- 🕵️Open your WordPress site in a new incognito/private 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 WordPress website.
- 🎯Test on a URL and device that match the toast targeting rules.
Toast Not Showing?
Most WordPress display issues come from cache, placement or targeting. Check these first.
Check page source
Open the WordPress page, view source, and search for widget.v1.js. If it is missing, the snippet is not installed in the active header.
Clear cache
Caching plugins, optimization plugins and CDNs can serve an older page version. Purge cache after adding the script.
Confirm targeting
If a toast targets a specific URL, device, schedule or exit-intent, test on a page and device that match those rules.
Publish the toast
Draft toasts never appear publicly. Open the toast editor, select your WordPress website and publish it.
Frequently Asked Questions
Find the information you need in a snap. Complete answers to make your experience easier.
Do I need a WordPress plugin?+
No. A header scripts plugin is the easiest option, but you can also paste the snippet into header.php if you are comfortable editing theme files.
Where exactly should I paste the ToastUp snippet?+
Paste it in the site head, ideally right before the closing </head> tag. This lets ToastUp load on every page where your theme outputs the head section.
Will theme updates remove the snippet?+
If you edit a parent theme directly, updates can overwrite your changes. A header scripts plugin or a child theme is safer.
Why is my toast not showing on WordPress?+
Check that the snippet is present in the page source, the toast is published, the correct website is selected, targeting rules match the current URL, and cache has been cleared.
Ready to add ToastUp
to WordPress?
Create your account, copy one snippet and launch your first conversion toast.
Start Free with ToastUpWant the full tour first? See every ToastUp feature or Compare plans & pricing.