🧩 Troubleshooting / Common Issues
Having trouble with The Wheel of Name? Here are some quick fixes for the most common problems users face.
1. ⚙️ Why isn’t the wheel spinning when I click the arrow?
Make sure you’ve entered names into the list first. The wheel won’t spin if it’s empty.
Also check that JavaScript is enabled in your browser and try refreshing the page.
2. 📂 Why does my uploaded JSON file not load?
Ensure your JSON file follows the proper format, e.g.:
[ "Alice", "Bob", "Charlie" ]If there’s a missing bracket or comma, the file won’t be accepted.
3. 🎡 Why are names not showing on the wheel?
Click the Refresh Wheel button to re-render names.
If still blank, try clearing browser cache or disabling any ad-blockers.
4. 🏆 Why does the winner popup not appear?
Some browsers block popups or animations. Ensure popups are allowed, or reload with animations enabled.
5. 🐢 How do I fix slow wheel performance?
Too many names can slow rendering. Try reducing the number or splitting lists.
Closing other heavy browser tabs also helps performance.
6. 📱 My wheel looks distorted on mobile — how to fix it?
Rotate your phone to landscape mode or zoom out slightly.
The layout automatically resizes to fit most screen sizes.