ToolkitSuitePopupWhy Widget Isn't Showing
Troubleshooting

Why Widget Isn't Showing

If your Popup widget isn't appearing on your site, one of these five common causes is usually the reason. Work through each one in order.

---

1. Incorrect Script Installation

The Popup script must be present on every page where you want widgets to appear. A common mistake is adding the script to only one page (e.g., the homepage) and expecting it to work site-wide.

Fix: Make sure the Popup script snippet is included in your site's global header or footer so it loads on all pages.

---

2. Script Minification and Optimization Plugins

Third-party optimization tools that minify, combine, or defer JavaScript can alter the Popup script and prevent it from executing correctly.

Fix: Add an exception for the Popup script in your optimization tool's settings. Exclude it from minification, combination, and deferred loading.

---

3. Coming Soon or Maintenance Themes

Coming-soon and maintenance-mode themes typically block all external scripts from loading, including the Popup script.

Fix: Either insert the Popup script manually into the coming-soon template, or configure the theme to allow the script through.

---

4. Display Rules Preventing Display

The "Don't Show If" section in your widget's display rules may be preventing the widget from appearing. If you have previously viewed, closed, or subscribed through the widget, it won't show again based on those conditions.

Fix: Open an incognito/private browsing window to test your widget. This bypasses stored cookies and display-rule conditions from prior visits.

---

5. One Widget at a Time

By default, Popup only shows one floating widget at a time. If another floating widget is already displayed, your widget will be queued and won't appear simultaneously.

Fix: If you need multiple floating widgets to appear at once, disable the "one widget at a time" setting in your widget's display rules.

---

Need more help?

If you've worked through this and still need a hand, contact support — we'll dig in with you.