This guide walks you through every feature and configuration option in Wheelr, the free customizable giveaway wheel for streamers, teachers, and event organizers.
1️⃣ Open wheelr.xyz in any modern browser (Chrome, Firefox, Edge, Safari)
2️⃣ You'll see the spinning wheel in the center of the screen
3️⃣ Settings panels are accessible from buttons around the wheel
4️⃣ No account needed — start customizing immediately!
💡 Tip: Wheelr works best in full-screen mode. Press
F11to maximize your browser window.
The Users panel is where you manage names (entries) on the wheel.
| Action | What It Does | |
|---|---|---|
| ➕ | Add repeated entries | Add a name multiple times (e.g., “John × 5” = 5 slots) |
| 🔀 | Shuffle | Randomize the order of all entries |
| 🗑️ | Clear all | Remove every name from the wheel |
| ❌ | Remove specific | Delete a single entry by name |
💡 Weighted odds: More entries for a name = higher chance of winning. Use repeated entries to give weighted odds in your random raffle wheel.
Click the SPIN button in the center of the wheel. The wheel spins for the configured duration and gradually slows to land on a random winner.
If enabled in Sound settings:
3️⃣ → 2️⃣ → 1️⃣ → 🎡 SPIN!
A countdown timer appears, an optional sound plays, and then the wheel spins automatically.
| Setting | Default | Effect |
|---|---|---|
| Spin time | 3 seconds | Shorter = quick picks, Longer = dramatic reveals |
After each spin, the winner is added to a history list.
| Setting | Options |
|---|---|
| 📋 Show winners list | Toggle on/off |
| 📐 Panel position | Left · Top · Right · Bottom |
The Color Settings panel gives you full control over your online prize wheel appearance.
Choose from built-in themes or create your own:
| Palette | Style | Vibe |
|---|---|---|
| 🌈 Vibrant | Bright, high-contrast rainbow | Fun, energetic |
| 🔴 Red | Warm red and orange tones | Bold, intense |
| 💜 Neon | Electric neon on dark backgrounds | Gaming, nightlife |
| 🌊 Ocean | Cool blues and teals | Calm, professional |
| 🌅 Sunset | Orange to purple gradient | Warm, creative |
| 🎨 Custom | Your own color set | Fully branded |
| Setting | Description | |
|---|---|---|
| 🎨 | Background color | Set a solid hex color for the page |
| 🖼️ | Background image | Upload a custom image (stored locally) |
🎮 Streamer tip: Upload your stream overlay background to make the wheel blend seamlessly into your OBS scene.
| Setting | Description |
|---|---|
| Center image | Upload logo, avatar, or brand image |
| Center color | Solid color for the center circle |
| Center text | Custom text (default: “SPIN”) |
| Logo size | S · M · L · XL · XXL · XXXL |
| Setting | Description | |
|---|---|---|
| 🔤 | Font family | Default is “Inter” sans-serif |
| 🌐 | Google Fonts | Search and apply any font from the full library |
| 💾 | Persistence | Fonts are dynamically loaded and saved across sessions |
🏷️ Branding tip: Use your brand font on the wheel for a cohesive look across your stream or event.
The Effects panel controls how winners are selected and celebrated.
| Mode | Description | |
|---|---|---|
| 🎡 | Wheel | Traditional circular spinning wheel — the classic experience |
| 📜 | Linear | Horizontal scrolling cards with physics-based deceleration |
| 🃏 | Cards | Card-suit-based extraction (♣ ♠ ♥ ♦) |
| Effect | Visual Description | |
|---|---|---|
| 🔥 | Fire | Realistic fire particles, floating embers, and smoke |
| 🎊 | Confetti | Colorful confetti pieces with rotation and gravity |
| 🎆 | Fireworks | Explosive sparks with arcing trajectories |
| 👏 | Applause | Animated clapping hands with 4 diverse skin tones |
The pointer indicates the winning slice:
| Pointer | Shape | Pointer | Shape | |
|---|---|---|---|---|
| 💧 Drop | Classic teardrop | ⭐ Star | Star shape | |
| ➡️ Arrow | Directional arrow | 💎 Diamond | Diamond/gem | |
| 👆 Finger | Pointing finger | ⚡ Bolt | Lightning bolt |
🔄 The pointer color automatically adjusts for contrast against the wheel slice it’s touching.
The Sound panel lets you add custom audio to your giveaway spinning wheel.
| Sound | When It Plays | |
|---|---|---|
| 🔊 | Spin audio | While the wheel is spinning |
| 🏆 | Winner audio | When a winner is announced |
| ⏱️ | Countdown audio | During the pre-spin countdown |
1️⃣ Open the Sound settings panel
2️⃣ Click the upload button for the desired channel
3️⃣ Select an audio file (MP3, WAV, OGG, etc.)
4️⃣ Sound is stored locally — persists across sessions
Use the global sound on/off toggle to mute all audio instantly.
Useful for quickly silencing the wheel during a stream break.
| Setting | Description | Default |
|---|---|---|
| Enable countdown | Toggle pre-spin countdown on/off | Off |
| Countdown start | Starting number | 3 |
The Wheel Manager lets you create and manage multiple wheel configurations.
1️⃣ Open the Wheel Manager panel
2️⃣ Click "Create New Wheel"
3️⃣ Enter a name and optional description
4️⃣ New wheel starts with default settings
| Action | Description | |
|---|---|---|
| ▶️ | Load | Switch to a saved wheel — all settings update instantly |
| ✏️ | Rename | Change name and description |
| 🗑️ | Delete | Permanently remove a wheel |
| 🔗 | Group | Create parent-child wheel relationships |
Display 1 to 4 wheels simultaneously:
💡 Use case: Display a “Prize Category” wheel and a “Winner” wheel side by side for a two-step giveaway!
Share your wheel for interactive live events.
1️⃣ Save your wheel to the cloud (requires free account)
2️⃣ A public URL is generated automatically
3️⃣ Share the link — anyone can open and spin!
| Feature | Detail |
|---|---|
| 🔒 Read-only | Viewers cannot modify settings |
| 🔄 Idle animation | Gentle rotation when not spinning |
| 📱 Responsive | Canvas adapts to viewer’s screen |
🎪 Event tip: Print the QR code on flyers or display it on a projector at trade shows and conferences.
| Method | Description |
|---|---|
| 📧 Email + Password | Classic registration |
| 🔵 Google sign-in | One-click OAuth via Google |
| Feature | Description | |
|---|---|---|
| 💾 | Save to cloud | Back up complete wheel configuration |
| 📥 | Import from cloud | Restore wheels on a new browser or device |
| 🔄 | Cross-device sync | Access the same wheels from any computer |
| 🕐 | Timestamps | Track when wheels were last saved |
🔒 Privacy: Cloud storage is optional. You can use Wheelr entirely offline. Only you can access your saved wheels.
| Tip | Why |
|---|---|
| Use OBS Browser Source | Embed Wheelr directly in your stream scene |
| Toggle UI Chrome off | Show only the wheel — no distractions |
| Upload stream alerts as winner audio | Branded celebration moments |
| Set channel logo as center image | Consistent branding |
| Tip | Why |
|---|---|
| Use shuffle before each spin | Ensures fairness |
| Enable the countdown | Builds classroom excitement |
| Share via QR code on projector | Students follow along on their phones |
| Create multiple wheels | Different wheels for different activities |
| Tip | Why |
|---|---|
| Create separate workspaces | One per prize category |
| Use 4-wheel display | Multi-category draws on one screen |
| Generate public links | Attendees follow along on phones |
| Set custom background | Match your event branding |
- Weighted odds: Add a name multiple times to increase chances
- Quick reset: Clear all names and paste a new list for the next round
- Font impact: Try “Bangers” or “Permanent Marker” from Google Fonts
- Pointer choice: ⚡ Bolt for energy, ⭐ Star for premium feel
| Issue | Solution |
|---|---|
| 🔇 Sound doesn’t play | Click anywhere on the page first — browsers block autoplay until user interaction |
| 🔍 Wheel looks small | Reduce the visible wheel count to 1 for maximum size |
| ❓ Settings disappeared | You may have cleared browser data — use cloud sync to prevent loss |
| 🔗 Public link doesn’t work | Make sure you saved the wheel to the cloud first |
| 🔤 Font not loading | Check internet connection — Google Fonts requires online access |