Frequently Asked Questions

StreamJuice Giveaways is a free, interactive prize wheel designed specifically for Twitch streamers. It allows your viewers to join giveaways directly from your chat using a simple command, and you can display the entire process live on your stream through an OBS overlay.

Yes, the core features of StreamJuice are completely free to use. We believe every streamer should have access to great tools to engage their community. We are supported by donations, which are greatly appreciated and help us cover server costs and continue development, but they are never required.

No! The basic wheel on the front page is available for everyone to use without an account or Twitch integration. You can manually type or paste names into the text box and spin the wheel for any purpose.

An account is only required if you want to use the advanced features like the OBS overlay, Twitch chat integration, and saving your wheel customizations.

Because the bot backend is upgraded for better stability and speed, old authentication tokens may not work correctly anymore. Re-linking your Twitch account ensures your chat connection is fresh, stable, and fully compatible with the newest features.

It only takes a few seconds, go to your Dashboard, click “Disconnect Twitch,” then click “Link Twitch” again.

You can easily add multiple entries for a single person using a special format. This works for everyone, whether you are logged in or just using the wheel on the main page.

In the text box, simply type the name followed by a space, an exclamation mark, and the number of entries. For example, to give "AwesomeViewer" 5 entries, you would type:

AwesomeViewer !5

This will automatically add "AwesomeViewer" to the wheel 5 times, increasing their chances to win.

No, the order is completely random! To keep things fair and exciting, the wheel wedges are automatically shuffled into a new random order every time the list of entries is updated. This ensures that the layout is unpredictable for every spin.

When you sign up and link your Twitch account, StreamJuice is authorized to send messages in your channel on your behalf. You can then "start" the wheel from your dashboard, which allows the service to listen for your custom join command (e.g., `!join`) in chat. When a viewer uses the command, a confirmation message is posted from your account, and they are automatically added to the wheel!

As the streamer or a moderator, you can use several commands in your chat to control the wheel. All command names (except the !) are customizable from your dashboard.

• !startwheel Starts the wheel using your last saved settings.
• !startwheel with flags and key=value options

  The new system lets you modify wheel behavior on the fly using a flexible command:

  !startwheel [flags] [key=value pairs]

  Available Flags:
  • sub — Subscriber-only mode
  • follower — Follower-only mode
  • paid — Marks wheel as a paid activation
  • supportbonus — Enables Support Bonus Mode
  Available key=value options:
  • max=NUMBER — Max joins per person
  • cd=NUMBER — Entry cooldown (minutes)
  • beingsub=NUMBER — Bonus entries for active subs
  • bitbonus=NUMBER — Bonus per X bits
  • giftsub=NUMBER — Bonus per gifted sub
  • buysub=NUMBER — Bonus per purchased sub

  Examples:

  • !startwheel max=3 cd=10 beingsub=5
    → Max 3 joins, 10-min cooldown, subs get +5 entries.
  • !startwheel sub max=5
    → Subscriber-only wheel with max 5 joins.
  • !startwheel follower cd=2
    → Follower-only wheel with 2-minute cooldown.
  • !startwheel supportbonus bitbonus=50 giftsub=1 buysub=1 beingsub=10
    → Support bonus with bonus amounts + extra 10 entries for subs.
  • !startwheel paid bitbonus=100 giftsub=2 buysub=1
    → Paid only mode with Bits & subs entries amounts.
  • !startwheel
    → Starts the wheel using saved default settings.
• !stopwheel: Closes the wheel to new entries.
• !spinwheel: Spins the wheel and selects a winner.
• !add [name] x[amount]: Adds manual entries from chat.
  Example: !add @Viewer x5
• !resetwheel: Clears all entries and stops the wheel.

Your viewers only need to use the join command: !join (or whatever you renamed it to).

The Subscriber Bonus is a great way to reward your supporters! When enabled, you can give your Twitch subscribers extra entries every time they join a giveaway.

For example, if you set the bonus to 3:

• A non-subscriber who types !join gets 1 entry.
• A subscriber who types !join gets 3 entries.

This bonus does not affect a user's join limit. If you set "Max Joins per Person" to 2, a subscriber can still join twice, getting 3 entries each time for a total of 6 entries on the wheel.

Note: This feature is automatically disabled if you start the wheel in "Subscribers Only" mode. In that mode, all subscribers get 1 entry per join to keep it fair.

For Viewers: When the wheel is active, anyone in your chat can use your designated join command (e.g., `!join`). However, you can now restrict giveaways to be for Subscribers Only. This can be enabled with a chat command (e.g., !startwheel sub) or by using the toggle switch in the Wheel Settings on the main page.

For Streamers & Mods: The administrative commands (like `!startwheel`, `!stopwheel`, `!spinwheel`, `!resetwheel`, and `!add`) can only be used by the broadcaster (you) and your channel's assigned moderators. This ensures you have full control over your giveaways.

On your dashboard, you'll find a unique "Overlay URL." Simply copy this URL and add it as a new "Browser Source" in your streaming software (like OBS, Streamlabs, etc.). We recommend setting the dimensions to 1920x1080 to match your stream canvas. The overlay is transparent, so it will appear seamlessly over your content.

Absolutely! Your dashboard has a powerful customization section. You can choose from dozens of pre-built themes, manually change every color, add your own logo to the center of the wheel, use a custom background image, and even change the tick sounds. You can also customize all the chat commands and the response messages that are posted from your account, including the message shown to non-subscribers who try to enter a sub-only giveaway.

To help you design the perfect custom background, we've created a template that shows you the "safe zones" for your graphics so they aren't covered by the wheel wedges.

The recommended image size is 1024x1024 pixels.

Click the thumbnail below to view the template and download it.

Yes! On the main wheel page, there is a mute button (🔇/🔈) next to the spin and reset controls. You can click this at any time to toggle the wheel's tick sounds on or off. Your preference will be automatically saved in your browser for your next visit.

The Raffle Bowl is an alternate visualizer mode where your entries become colorful balls inside a floating glass bowl! When you draw a winner, the winning ball rises dramatically and the rest fall back down. It feels more like a lottery-style drawing instead of a prize wheel.

You can switch between Wheel and Raffle Bowl anytime using the visualizer controls on your dashboard.

You can also choose different bowl animation styles (Popcorn, Tornado, or UFO Tractor Beam) to match your stream’s vibe.

Custom sounds let you personalize your wheel spins with your own audio clips. You can upload a sound file directly or provide a link to one.

• File Upload: You can upload an audio file up to 3MB in size. Accepted formats are .mp3, .wav, or .ogg.
• URL Option: If you have a direct link to a valid sound file, you can paste the URL instead of uploading.

When a custom sound is added, it will override all tick sound settings — including the “No Sound” option. During a spin, your custom audio will automatically loop for the entire spin duration and fade out smoothly right as the winner is announced.

If the uploaded or linked sound isn’t long enough to cover the whole spin, it will automatically restart to maintain continuous sound. You can remove or replace your custom sound at any time in the Wheel Settings panel.

You now have even more control over how your StreamJuice overlay appears on stream. You can adjust size and position, toggle alerts, and choose whether the wheel is always visible — all through simple URL parameters.

Method 1: URL Parameters (Recommended)

Use these parameters at the end of your overlay URL. Separate each one with an &. The values are in pixels where noted.

• &wheel=... — Sets the size (height and width) of the wheel.
  Example: &wheel=500
• &x=... — Moves the overlay horizontally. Positive = right, negative = left.
  Example: &x=-600
• &y=... — Moves the overlay vertically. Positive = down, negative = up.
  Example: &y=-200
• &attract=1 — Keeps the wheel visible at all times (Attract Mode).
• &alerts=0 — Disables alerts (wheel only).
• &alertonly=1 — Shows only alerts (no wheel, no attract mode).

Putting it all together: To create a 500px wheel that stays visible and hides alerts, your final URL would look like this:

https://giveaways.streamjuice.xyz/overlay.php?key=YOUR_KEY&wheel=500&x=-600&y=-200&attract=1&alerts=0

Or, for an alerts-only overlay (no wheel):

https://giveaways.streamjuice.xyz/overlay.php?key=YOUR_KEY&alertonly=1

Method 2: Custom CSS (Advanced)

For complete layout control, you can use Custom CSS inside your Browser Source properties in OBS or other streaming software. This is ideal for fine-tuning or adding effects like borders or shadows.

The two main CSS targets are:

• #wheelCanvas — controls the size of the wheel.
• #wheel-wrapper — controls the position of the wheel.

Positioning Examples

Here are some examples for a smaller (500px) wheel on a 1920x1080 canvas.

Top-Left Corner:

#wheelCanvas {
    height: 500px;
    width: 500px;
}
#wheel-wrapper {
    top: -200px;
    left: -600px;
}

Top-Right Corner:

#wheelCanvas {
    height: 500px;
    width: 500px;
}
#wheel-wrapper {
    top: -200px;
    left: 600px;
}

Bottom-Left Corner:

#wheelCanvas {
    height: 500px;
    width: 500px;
}
#wheel-wrapper {
    top: 200px;
    left: -600px;
}

Bottom-Right Corner:

#wheelCanvas {
    height: 500px;
    width: 500px;
}
#wheel-wrapper {
    top: 200px;
    left: 600px;
}

Combine these options however you like — you can even layer multiple overlays (for example, one for alerts and one for the wheel) to get the exact layout you want.

The __bonus__ text is a hidden, internal tag the bot uses to distinguish a subscriber's bonus entries from their standard ones. It should never be visible on the live wheel or in the winner announcement.

If you see this text, it usually indicates a temporary display issue where the overlay hasn't received the cleaned-up list of names from the bot yet. Please try the following steps:

• 1. Refresh the Page: The simplest fix is to refresh your overlay page. In OBS, you can right-click the Browser Source, go to "Properties," and click the "Refresh cache of current page" button.
• 2. Check Connection: If it persists, it may be a brief connection issue. Wait a moment for a new viewer to join, which will trigger a fresh update to the wheel.
• 3. Relink Twitch: If the issue continues to happen frequently, try going to your dashboard, disconnecting your Twitch account, and then linking it again. This establishes a fresh connection token.
• 4. Contact Support: If none of the above steps resolve the issue, please reach out to us for help at support@streamjuice.xyz.

If messages stop posting in your chat or the status on the homepage is stuck on "Connecting to server...", your authentication token from Twitch may have expired. This is normal and can happen for various security reasons.

The first thing to try is to go to your dashboard, disconnect your Twitch account, and then link it again. This usually resolves the issue immediately by generating a fresh connection.

If you find you are having to do this frequently, please reach out to us, as it may indicate a bug we need to investigate. You can contact us at support@streamjuice.xyz.

This can happen when a "ghost" connection to your chat is left behind after the bot restarts or refreshes its connection, causing two instances to respond to the same command.

The most effective way to solve this is to force a completely fresh, single connection by re-linking your Twitch account. Please follow these steps:

• 1. Go to your Dashboard: Navigate to your main dashboard page on StreamJuice Giveaways.
• 2. Disconnect Twitch: Use the button to disconnect your Twitch account from the service.
• 3. Link Twitch Again: Immediately after disconnecting, click the button to link your Twitch account again.

This process generates a brand new, clean connection and should resolve the double-posting issue. If the problem continues to happen frequently after re-linking, please contact us for support at support@streamjuice.xyz.

Changes to your wheel's design should appear automatically on the overlay, even while OBS is running. However, streaming software sometimes aggressively caches browser sources.

If your overlay isn't updating, right-click on the StreamJuice Browser Source in OBS and select "Properties." At the bottom of the properties window, you should see a "Refresh cache of current page" button. Clicking this will force OBS to fetch the latest version of your wheel design.

If you are still having issues after refreshing the cache, please contact us for support at support@streamjuice.xyz.

Yes. We take your privacy and security seriously. We only request the minimum permissions necessary from Twitch to operate the service. All passwords and Twitch authentication information are securely encrypted in our database. New accounts are required to verify their email address before they can access registered features.

You have full control over your account. You can disconnect your Twitch account or permanently delete your entire account at any time from your dashboard. For more details, please see our Privacy Policy and Terms of Service.

The best place to get live support, share suggestions, and see the latest updates is our official Discord channel!

We have a helpful community and you can speak directly with the developer. Click the link below to join:

Join the StreamJuice Discord Server