StreamJuice is community-supported. Server costs run about $0.25/day. Important Update Support StreamJuice

StreamJuice Giveaways FAQ

Search for answers, browse by topic, or jump into video tutorials for setup, overlay help, wheel features, channel point rewards, auto spin, Twitch chat commands, and troubleshooting.

No matching results.

Try a different keyword like overlay, commands, channel points, auto spin, placeholders, claim, entry notes, attract mode, raffle bowl, elimination, or Twitch.

Getting Started

Basics for using the wheel manually or with a StreamJuice Giveaways account.

Basics

StreamJuice Giveaways is a free, interactive prize wheel built for Twitch streamers. Viewers can enter from chat, you can spin the wheel live, and the process can be shown on stream through an OBS browser overlay.

Yes. The core StreamJuice Giveaways features are free to use. Donations help support server costs and future development, but they are never required to use the giveaways tool.

No. The main wheel can be used without an account by typing or pasting entries manually.

You only need an account if you want saved settings, Twitch chat integration, OBS overlays, and dashboard customization.

Wheel Features

Core wheel behavior, multiple giveaway lists, weighted entries, shuffle behavior, claim windows, and elimination mode.

Wheel

Use the special entry format:

AwesomeViewer !5

That adds the same viewer five times. This works on the main page and in saved wheel entries.

Logged-in users can run up to three separate giveaway lists. Each list keeps its own name, giveaway key, entries, claim time, and wheel design settings.

That means you can keep different giveaways ready at the same time instead of rebuilding the wheel from scratch every time.

For example, you could have one list for a follower goal giveaway, one list for subscribers, and one list for a special event. Switching tabs changes which giveaway you are editing and controlling.

Your default giveaway is the one StreamJuice uses when no specific giveaway key is provided.

If your overlay link does not include a giveaway key, the overlay will show your default giveaway. If chat commands are used without a giveaway key, they will also apply to your default giveaway.

This makes it easy to keep one main giveaway live while still having other giveaway lists saved and ready.

No. The wheel layout is randomized so the wedge order stays unpredictable and fair.

Elimination Mode repeatedly spins and removes one entrant at a time until only one winner remains.

It uses your current spin duration and announce delay for each round.

From chat, moderators can start it with !spinwheel elimination or use the elimination controls in the dashboard.

Moderators can also stop the current elimination round early with !pausespin. This acts like a pause or emergency stop. The remaining names stay on the wheel so the spin can be started again later.

Entry Notes let viewers add a short message with their entry. This is useful for things like game suggestions, dare ideas, song requests, character names, or prize choices.

Example chat entry:

!join 007 Golden Eye

If Entry Notes are enabled, StreamJuice can put that note on the wheel instead of only showing the viewer name.

  • Username and note displays like viewername: 007 Golden Eye.
  • Note only displays like 007 Golden Eye.

Even when the wheel displays only the note, StreamJuice still tracks the real viewer behind that entry. That way winner announcements can tag the viewer instead of tagging the note text.

Yes. If a viewer receives more than one entry because of a subscriber bonus, their note is copied to the bonus entries too.

For example, if a subscriber enters with !join Destiny 2 Raid and your sub bonus gives two entries, both entries will keep the same note instead of one note entry and one plain username entry.

Yes. Winners can type extra text after the claim command, up to 35 characters including spaces.

Example:

!claim MyInGameName

This is useful when you need a game username, server name, Discord name, or other short delivery detail. The claim message is saved with the claim record and can be viewed later in analytics.

Tip: If your claim prompt asks for a giveaway key or other detail, tell viewers to follow the exact prompt shown in chat.

Yes. The main wheel has a mute button you can toggle at any time. Your preference is saved in your browser for future visits.

Twitch & Chat Commands

How chat integration works and what the main commands do.

Twitch

When you link your Twitch account, StreamJuice Giveaways can send messages in your channel on your behalf. Once the wheel is started, viewers can use your join command in chat to enter automatically.

Command names can be customized in your dashboard, but the defaults are:

  • !startwheel starts a giveaway using your saved settings.
  • !stopwheel stops new entries.
  • !spinwheel spins the wheel normally.
  • !spinwheel elimination starts elimination mode.
  • !pausespin stops the current elimination round early and keeps the remaining entries.
  • !showwheel shows the overlay wheel or bowl.
  • !hidewheel hides the overlay wheel or bowl until it is shown again or a spin starts.
  • !resetwheel clears the current giveaway.
  • !shuffle shuffles entries in the current giveaway.
  • !add @Viewer x5 manually adds entries.
  • !claim MyInGameName lets a winner claim and include a short claim message.

Viewers normally enter with your join command, such as !join or whatever custom command you set.

If you use multiple giveaway lists, you can also target a specific giveaway by adding its giveaway key after the command. For example:

  • !join 1k
  • !startwheel 1k
  • !spinwheel 1k

If no giveaway key is included, StreamJuice uses your default giveaway automatically.

A giveaway key is a short single-word identifier for one specific giveaway list.

It lets you target the correct giveaway from chat. For example, if your giveaway key is 1k, viewers can enter that giveaway with !join 1k.

Keys are especially useful when you have more than one giveaway saved, because they let you control or enter the exact giveaway you want instead of always using the default one.

Each giveaway list can have its own claim time. When a winner is chosen, StreamJuice can prompt them in chat and give them a set number of minutes to claim their prize.

The claim prompt can include the giveaway name, claim command, and giveaway key, which helps viewers know exactly which giveaway they won if you are running more than one list.

Winners can also include a short claim message after the claim command. For example, !claim MyInGameName. This is saved with the claim record and can be viewed later in analytics.

If the winner does not claim in time, the claim window expires and you can decide what to do next on your stream.

The Subscriber Bonus lets you award extra entries whenever a subscriber joins. For example, if you set the bonus to 3, subscribers get three entries per join while non-subscribers get one.

This does not change the join limit. It only changes how many entries are added per successful join.

These commands give moderators more control during a live stream.

  • !pausespin stops the current elimination spin early and keeps the remaining names on the wheel.
  • !showwheel forces the overlay wheel or bowl to show, even if your overlay link does not use &attract=1.
  • !hidewheel hides the overlay wheel or bowl until it is shown again.

If the wheel is hidden and a real spin starts, StreamJuice will still show the wheel for the spin. After the winner flow finishes, it can return to hidden if that was the last overlay visibility command used.

Yes. In your dashboard, you can change command names such as join, start, stop, spin, pause elimination, show wheel, hide wheel, reset, add, shuffle, and claim.

You only type the command word in the dashboard. Do not include the ! prefix there. StreamJuice adds the ! prefix in chat.

If a command field is left empty, StreamJuice uses the default command for that field.

Viewers use the join command while the wheel is active. Administrative commands like start, stop, spin, reset, and add are limited to the broadcaster and channel moderators.

Channel Point Redeems

Let viewers redeem Twitch channel points for giveaway entries.

Rewards

Channel point redeems let viewers spend Twitch channel points to add entries automatically.

Each giveaway list can have its own channel point rewards. You can create a Twitch reward from the dashboard, choose how many entries each redeem gives, and decide whether those entries count toward the user’s max join limit.

  • Counts toward max: the redeem is treated like a normal entry and respects the max entries per user.
  • Does not count toward max: the redeem adds bonus entries without using the viewer’s normal join limit.

This makes it possible to run normal free joins and optional channel point bonus entries at the same time.

Open the giveaway list you want to edit, then open the Channel Point Redeems section. Use the create button to let StreamJuice create the reward on Twitch.

After Twitch creates the reward, StreamJuice stores the Twitch reward ID behind the scenes. You do not need to show or edit that ID manually.

If you delete a reward from StreamJuice, StreamJuice will also try to delete the matching reward on Twitch.

Important: If you change only the giveaway list name or giveaway key, that is saved in StreamJuice. Twitch does not need to be updated for simple list name or key changes.

Creating and deleting channel point rewards requires Twitch permissions that older linked accounts may not have granted.

If the Channel Point Redeems section is missing, disabled, or reward creation fails, disconnect Twitch from the dashboard and link it again. This refreshes your permissions.

The reward tools are only shown for users who have Twitch linked.

Yes. Channel point entries have their own customizable chat messages so they do not have to use the same response as a normal join.

Examples:

🎟️ @{name} redeemed {rewardTitle} and got {entriesAdded} channel point entry! ({joinCount}/{maxJoins})
✨ @{name} redeemed {rewardTitle} and got {entriesAdded} bonus channel point entries!

Use {rewardTitle} to show the Twitch reward name, {entriesAdded} to show how many entries were added, and {joinCount} plus {maxJoins} when the redeem counts toward the max entry limit.

Chat Messages & Placeholders

Customize bot messages and use placeholders to insert live giveaway details.

Messages

Placeholders are words inside curly braces that StreamJuice replaces when the message is sent.

For example, this custom message:

✅ @{name}, you are in! ({joinCount}/{maxJoins})

could become this in Twitch chat:

✅ @KiraKhaos, you are in! (2/4)

If a placeholder has no matching value for that message, it may show blank or stay unchanged, so only use placeholders listed for that message type.

Placeholder What it means Example output
{name}The viewer who triggered the message. Also used as the safe Twitch username in some elimination messages.KiraKhaos
{giveawayName}The display name or tracking name of the giveaway list.June Prize Wheel
{giveawayKey}The short key used to target a giveaway list from chat.list1
{joinCommand}Your join command without the ! prefix and without the giveaway key.enter
{joinTarget}The full join command viewers should type, including the giveaway key when needed.!enter list1
{joinCount}How many counted joins that viewer has used. Bonus weighted entries do not increase this number.2
{maxJoins}The max counted joins allowed for that viewer.4
{maxEntries}The max entry or max join setting shown in some start messages.4
{cooldown}Cooldown time remaining or configured cooldown minutes.5
{entriesAdded}How many entries were added by a join, subscriber bonus, paid event, or channel point redeem.3
{entriesRemoved}How many entries were removed when a viewer used the leave command.2
{entryPlural}Automatically becomes entry or entries based on how many were removed.entries
{entryName}The entry manually added by a moderator.AwesomeViewer
{count}How many times a manual entry was added.5
{mod}The moderator who used the add command.HelpfulMod
{winner}The real winning Twitch username. Use this when tagging the winner.KiraKhaos
{winnerUser}The real winning Twitch username. This is also safe to tag.KiraKhaos
{winnerName}The winning Twitch username in a display-friendly form.KiraKhaos
{winnerEntry}The full winning entry display, including Entry Notes if used.kirakhaos: 007 Golden Eye
{winnerPick}The wheel/display text for the winning entry. With Entry Notes, this is the viewer’s displayed pick or note.007 Golden Eye
{winnerDisplay}The best display text for the winning entry.kirakhaos: 007 Golden Eye
{eliminated}The real Twitch username eliminated during elimination mode. Use this when tagging the eliminated viewer.KiraKhaos
{eliminatedEntry}The full eliminated entry display, including Entry Notes if used.kirakhaos: Random Dare
{eliminatedPick}The wheel/display text for the eliminated entry.Random Dare
{eliminatedDisplay}The best display text for the eliminated entry.kirakhaos: Random Dare
{claimMinutes}How many minutes the winner has to claim.3
{claimCommand}Your claim command without the ! prefix.claim
{claimMessage}The extra text a winner typed after the claim command, such as an in-game name.MyInGameName
{rewardTitle}The Twitch channel point reward title.1 Giveaway Entry
{entriesPerSub}How many entries are awarded for a subscription in paid mode.1
{entriesPerGiftSub}How many entries are awarded per gifted sub in paid mode.1
{entriesPerBits}How many bits are needed per entry in paid mode.100
{giftedAmount}How many gift subs were gifted.5
{cheerAmount}How many bits were cheered.500

Wheel start:

🎯 {giveawayName} is now open! Type {joinTarget} to enter.

Example output:

🎯 List 1 is now open! Type !enter list1 to enter.

Normal join:

✅ @{name}, you are in! ({joinCount}/{maxJoins})

Example output:

✅ @KiraKhaos, you are in! (2/4)

Winner with Entry Notes:

👑 Congratulations @{winner}, you won with "{winnerPick}"!

Example output:

👑 Congratulations @KiraKhaos, you won with "007 Golden Eye"!

Claim success with claim message:

✅ @{name}, your win for {giveawayName} has been claimed! Message: {claimMessage}

Example output:

✅ @KiraKhaos, your win for List 1 has been claimed! Message: MyInGameName

Channel point redeem:

🎟️ @{name} redeemed {rewardTitle} and got {entriesAdded} entries! ({joinCount}/{maxJoins})

Example output:

🎟️ @KiraKhaos redeemed 1 Giveaway Entry and got 2 entries! (2/4)

Use @{winner} or @{winnerUser} when you want to tag the actual Twitch viewer.

This matters when Entry Notes are set to note only. The wheel may show The Goonies, but the real winner might be KiraKhaos. Using @{winner} tags the real viewer instead of trying to tag the note text.

Use {winnerPick} when you want to show the viewer’s note or pick.

Yes. In Chat Settings, each customizable message can be enabled or disabled. Disabled messages are saved as off and will not be sent.

Claim prompts can also be silenced per giveaway list. If claim messages are silenced, StreamJuice will still track the claim, but it will not post the claim prompt messages in chat.

Auto Spin Timer

Automatically spin a giveaway after a set countdown without server polling every second.

Timer

The Auto Spin Timer lets you open a giveaway and have StreamJuice spin it automatically after a countdown.

You can set the timer from 1 second up to 3600 seconds, which is 1 hour. Each giveaway list has its own auto spin setting.

The dashboard and overlay show a countdown ring and time label while the timer is running.

Yes. Auto Spin can use regular spin or elimination spin.

Elimination Auto Spin is meant for the wheel visualizer. If you are using the Raffle Bowl, Auto Spin should use regular spin.

The timer label will show AUTO 00:30 for regular auto spin or ELIM 00:30 for elimination auto spin.

Auto Spin is a one-shot timer. After the timer fires and the spin runs, StreamJuice sets the giveaway inactive.

This prevents the same list from repeatedly spinning by accident. To run another timed giveaway, start the giveaway again.

If there are not enough entries when the timer ends, StreamJuice can send the not enough entries message and still turn the list inactive.

A manual spin cancels the active auto spin timer for that giveaway list.

Manual spins do not force the giveaway inactive afterward. The one-shot inactive behavior only applies when the spin was triggered by the Auto Spin Timer.

Overlay & OBS

Setup instructions, overlay behavior, and layout control.

OBS

Copy your unique overlay URL from the dashboard and add it to OBS as a Browser Source. A 1920x1080 browser source is a good starting point for full-scene overlays.

Your overlay now uses your overlay pin in the URL, like this:

https://giveaways.streamjuice.xyz/overlay.php?pin=YOUR_OVERLAY_PIN

If you leave out a giveaway key, the overlay follows your current default giveaway automatically.

The recommended background size is 1024x1024. Use the template below to keep important art clear of the wedge area.

Wheel Background Template Thumbnail

You can customize the overlay using URL parameters.

  • &wheel=500 sets the wheel size in pixels
  • &x=-600 moves the overlay left or right
  • &y=-200 moves the overlay up or down
  • &attract=1 keeps the wheel visible
  • &alerts=0 disables alerts
  • &alertonly=1 shows alerts only

Example:

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

If you want the overlay locked to one specific giveaway instead of following your default giveaway, add that giveaway’s key too:

https://giveaways.streamjuice.xyz/overlay.php?pin=YOUR_OVERLAY_PIN&key=1k&wheel=500&x=-600&y=-200&attract=1

The overlay can be controlled from chat with the show wheel and hide wheel commands.

  • !showwheel shows the wheel or bowl on the overlay.
  • !hidewheel hides the wheel or bowl on the overlay.

This gives you another layer of control beyond the &attract=1 overlay URL option.

If the overlay is hidden and a real spin starts, StreamJuice will still show the wheel for the spin so viewers can see the result.

Yes. When Auto Spin is running, the overlay can show a countdown timer label and a ring around the wheel or bowl.

The timer label uses minutes and seconds, such as AUTO 00:30 or ELIM 00:30.

The countdown is drawn locally in the overlay browser source, so it does not need the server to send updates every second.

Raffle Bowl

Alternate visualizer mode and its animation styles.

Visualizer

The Raffle Bowl is an alternate visualizer where entries become balls inside a floating bowl. When a winner is chosen, the winning ball rises while the others fall back.

You can switch between the Wheel and Raffle Bowl from the dashboard and choose between animation styles like Popcorn, Tornado, and UFO Tractor Beam.

Custom Sounds

Upload or link custom spin audio.

Audio

You can upload a custom sound under 3MB or paste a direct sound URL. Supported formats include .mp3, .wav, and .ogg.

When a custom sound is set, it overrides the normal tick sound selection and loops during the spin before fading out near the winner announcement.

Troubleshooting

Fixes for the most common issues.

Help

__bonus__ is an internal tag used for bonus entries. If it appears visually, refresh your overlay and let the bot resend the cleaned entries list.

If chat messages stop posting or the connection seems stuck, your Twitch token may have expired. Disconnect Twitch in the dashboard and link it again to refresh the connection.

This is usually caused by an old ghost connection. Disconnect Twitch and relink it to force a fresh single connection.

OBS sometimes caches browser sources aggressively. Open the Browser Source properties and use the refresh cache option for the current page.

Usually this means Twitch permissions need to be refreshed or Twitch rejected the reward change.

Try disconnecting and relinking Twitch in the dashboard. Then create the reward again.

If you already created a similar reward directly in Twitch, check your Twitch Creator Dashboard for duplicate or disabled rewards.

First, make sure Auto Spin is enabled for the giveaway list you actually started. Each list has its own timer setting.

If the dashboard or overlay was already open, refresh the page or refresh the OBS browser source cache.

If the wheel was manually hidden with the hide wheel command, the timer label or ring may stay hidden until the overlay is shown again or the real spin begins.

If a command or overlay does not include a giveaway key, StreamJuice uses your default giveaway.

If you expected a different list, either set the correct giveaway as default or include the specific giveaway key in the command or overlay URL.

For example, use !join 1k in chat or add &key=1k to your overlay link if you want to target that specific giveaway.

Video Tutorials

Watch setup and walkthrough videos for StreamJuice Giveaways.

Video

BeardedInk Setup & Walkthrough

BeardedInk put together a full walkthrough for StreamJuice Giveaways, covering setup and usage in OBS. Big thanks to him for letting us feature it here.