Spin Wheel

⌘K
  2. Home
  4. Spin Wheel
  6. Troubleshooting
  8. Wheel Not Displaying: The Invisible Campaign

Wheel Not Displaying: The Invisible Campaign

“Where Did It Go?”

You spent hours designing the perfect wheel. You set the probability. You wrote the copy. You clicked “Publish.” You visit your homepage… and nothing happens.

This is frustrating, but it is rarely a “bug.” The Ultimate Spin Wheel is designed to be “smart.” It intentionally hides itself to prevent spamming your users. If it isn’t showing up, it usually means logic is telling it to hide.

This guide helps you decode that logic and find the missing wheel.

1. The “Who” (Cookie & Session Logic)

The #1 reason you can’t see the wheel is: You already played.

  • Logic: Once a user spins the wheel (or closes it, depending on your settings), we drop a browser cookie: uspw_already_played = true.
  • Reason: We don’t want to annoy users by showing the popup every single time they reload the page.
  • The Test:
    1. Open an Incognito / Private Window.
    2. Visit your site.
    3. If it shows up: The plugin is working perfectly. Your main browser just has the cookie.
  • The Fix:
    • Clear your browser cookies.
    • Or, go to Display Settings > Frequency and enable “Show on every page load” (Testing Mode). Remember to turn this off before going live!

2. The “Where” (Targeting Rules)

Did you tell the wheel to appear on the wrong page?

Page Targeting

  • Setting: Campaign > Visibility.
  • Check: Did you verify “Show on specific pages”?
    • If you selected “Home Page” but are testing on /shop, it won’t show.
    • If you selected “Posts” but are viewing a “Page”, it won’t show.

User Role Targeting

  • Setting: Display Settings > User Roles.
  • The Trap: “Hide for Logged-in Users”.
    • You are the Admin. You are logged in. Therefore, the wheel hides from you.
    • The Fix: Uncheck this box while testing, or use Incognito mode (where you are a guest).

Device Targeting

  • Setting: Display Settings > Devices.
  • The Trap: “Hide on Mobile”.
    • If you are testing on your iPhone, and this is checked, you won’t see it.

3. The “When” (Trigger Logic)

Did you tell the wheel to wait too long?

Exit Intent

  • Logic: “Show when mouse leaves the window.”
  • The Trap: On mobile, there is no mouse. “Exit Intent” often fails on phones because there is no “cursor leaving the screen” signal.
  • The Fix: Always set a “Backup Trigger” (e.g., Time Delay: 10 seconds) so mobile users eventually see the wheel.

Scroll Percentage

  • Logic: “Show after scrolling 50% down.”
  • The Trap: If your page is short (no scrollbar), the user can never reach “50%”.

4. The “Blocker” (Caching & Conflicts)

If Incognito mode fails, and your settings are perfect, something is breaking the code.

Serious Caching (Cloudflare / WP Rocket)

  • The Issue: Your server sends a “Stale” version of the HTML to the browser. This stale version might date back to before you installed the plugin.
  • The Fix:
    1. Purge Everything: Click “Clear Cache” in your WordPress admin bar.
    2. Cloudflare: Log in to Cloudflare and click “Purge Everything”.
    3. Minification: If you use “JS Minification,” disable it temporarily. If the wheel reappears, the minifier was breaking our code.

Script Conflicts (JavaScript Errors)

  1. Right-click your page > Inspect > Console.
  2. Look for Red Text.
    • Uncaught SyntaxError or ReferenceError.
    • If you see an error coming from another plugin (e.g., “Slider Revolution”), that error might be stopping the execution of ALL JavaScript on the page, including our wheel.
    • Test: Deactivate other plugins one by one to find the culprit.

5. Frequently Asked Questions (FAQ)

Q: I see the overlay (dark screen) but no wheel? A: This is a Z-Index issue. The wheel is there, but it is “behind” your website content. Add this to your Custom CSS: .uspw-container { z-index: 9999999; }.

Q: Does it work on draft pages? A: The wheel usually requires a page to be “Published” to trigger correctly, as some WordPress query logic ignores drafts. Publish the page (or password protect it) to test properly.

Conclusion

If the wheel is invisible, remember the troubleshooting mantra:

  1. Incognito Mode (Checks Cookies).
  2. Settings Review (Checks Logic).
  3. Console Log (Checks Errors).

99% of “Invisible Wheel” reports are solved by simply opening an Incognito window!

How can we help?