Run a giveaway in chat

The short answer

Bloopbot runs keyword giveaways in Twitch chat. You pick a word, viewers type it to enter, and Bloopbot draws a winner at random, who confirms by saying a second word in chat. You can limit entry to followers, to certain roles or to a minimum watch time, charge loyalty points for each ticket, give subs, VIPs and regulars better odds, draw more than one winner and have a winner who does not answer replaced. Giveaways are included on every plan.

From nothing to a winner:

1. Add the Giveaway pack from Flows → Add and switch its flows on. They are what enters viewers and announces the winner.
2. Open Giveaways in the sidebar, press New giveaway and name the prize.
3. On Entering, set the Keyword, such as lucky, and who can enter.
4. On Winner, choose how a winner confirms, then go on to Review and press Save.
5. Press Open in the Run panel. Chat is told the giveaway is open and which word to type.
6. Press Close and draw. Chat hears who won, and the winner types the confirm word to claim.

The rest of this guide covers each rule, running a giveaway from chat with mod commands, putting it on stream and letting viewers enter from the web.

Before you start

A giveaway is a record with its own rules: the prize, the word that enters it, how many winners there are, and how a winner claims it. You set it up once, open it when you are ready, and every line chat sees comes from a flow — so the wording is yours to change.

• Bloopbot connected to your channel so it can read and answer chat: Get started with Bloopbot walks through it.
• The Giveaway pack, from Flows → Add. It brings the flows a giveaway runs on: the !giveaway mod commands (one flow per command — Open a giveaway, Close a giveaway and the rest), !enter, keyword entry, the confirm word, and the winner announcement. If the Flows list already holds flows such as Giveaway status or Enter the giveaway, yours came with the pack earlier — check what is there instead of installing a second copy.
• Points, if a ticket is to cost anything: loyalty points are what a ticket spends. A giveaway whose ticket cost is 0 needs nothing here.
• The bot account as a moderator, as for any flow that reads and answers chat: make your bot a moderator by copying the /mod command from the Make your bot a mod step of Set up your bot or the Not a mod bar and sending it in your Twitch chat.

Giveaways are included for every channel, on every plan, including drawing more than one winner and letting viewers enter from the web. Your plan shows what your channel has.

Get help with your setup

Optional Help me explains your existing giveaway and its current state. Keep your first giveaway as a draft while reviewing entry channels, eligibility, ticket costs and the prize. Opening entries, drawing a winner and delivering the prize are separate choices; setup does none of them for you.

1. Set the rules

Open Giveaways in the sidebar, under Viewers, and press New giveaway. A new giveaway starts as a Draft: nothing in chat can see it yet.

Setting a giveaway up takes four steps — Prize, Entering, Winner and Review — shown along the top of the editor. Next saves what you changed and moves on, Back goes back without saving, and you can jump to any step from the step list; nothing you type is lost when you move between them. The address remembers the step you are on, so a reload keeps your place.

Prize

1. Under What are you giving away?, name the prize as chat reads it, such as “Friday key drop”. Tell viewers about it is optional, and so is Cover art.
2. Set Number of winners. One is the usual case.
3. Under How does the winner get it?, choose In chat, the classic exchange this guide covers, or Claim page for a real prize — a key, a gift link, something posted to them — that a winner signs in and claims for themself. Choosing Claim page brings the Prizes section into this step to stock what you are giving away; see Give away game keys and prizes.

Entering

1. Under Where do people enter?, Chat is ticked by default. Set its Keyword: the one word that enters the giveaway, such as lucky. Only one open giveaway can hold a keyword at a time, and it is not a command, so it takes no prefix. Tick Web too, or instead, to let viewers enter from the giveaway's own public page — see Let viewers enter from the web. Typing the keyword enters nobody by itself: a flow does the entering, and the Chat card names it — “Viewers who type “lucky” enter through your Enter with the keyword flow”. Under that line is the flow's status. Live means it is switched on, with Open flow beside it. Paused — nobody can enter from chat means the flow exists but is switched off; Open flow takes you to it to switch it on. No flow enters people from chat yet means the channel has no such flow; Add the Giveaway pack opens the pack in the Marketplace, with its review. Entering from the web does not need a flow.
2. Under Who can enter?, the line at the top says who can enter right now — Anyone. until you restrict it. Tick Followers only (and set how many days), pick roles under Only these roles, or set a watch-time minimum.
3. Open Tickets and points to decide what a ticket costs: Ticket cost (points) is spent per ticket, Max tickets each is how many one viewer may hold, and First ticket is free takes the cost off the first one they take. Left closed, entry is free with one ticket each.
4. Open Better odds for subs, VIPs and regulars if their tickets should weigh more. The best multiplier a viewer qualifies for is the one used; multipliers never stack.

Winner

1. Under How does a winner confirm?, choose Say a word in chat — set the Confirm word (one word, !claim by default) and the Seconds to confirm — or No confirmation, where the winner is final the moment they are drawn. With a word to say, If they don’t confirm in time, draw someone else redraws a winner whose window runs out. The confirm word works the same way as the keyword: the Say a word in chat card names the flow that confirms a winner — the pack's Claim with the confirm word — and shows Live, Paused — winners can’t confirm in chat, or No flow confirms winners from chat yet, with a link to the flow or to the pack.
2. Under When does it run?, choose I’ll open and close it myself, or On a schedule and fill in Opens and Closes.

Review

1. Read the giveaway back: one sentence each for the prize, entering, who can enter, the winner and when it runs, with a pencil icon (Edit) beside each to jump back to that step. Before it can open lists anything that would stop it opening — too few prizes stocked for the winners, a follow-lock Twitch cannot check yet, a plan limit — each with a button to the step that fixes it, or says Ready to open. It also lists a keyword or confirm-word flow that is paused or missing, with a link to the flow or to the Giveaway pack. The giveaway still opens without it, but nobody could enter or confirm from chat.

Press Save. The giveaway is still a draft, so nothing reaches chat yet — open it from the Run panel when you are ready.

2. Let chat enter

1. Press Open in the Run panel. The badge changes to Open, and the pack’s flow says so in chat: 🎉 Friday key drop is open! Type lucky to enter.
2. Type the keyword in chat as a viewer would: lucky. That line enters them. The pack’s defaults keep a successful entry quiet, so watch the Entries list on the page rather than chat.
3. A viewer who wants more than one ticket types !enter 3, or !ticket 3, and is charged for each ticket. !enter max takes the most they can hold.
4. Watch the run panel: the entry count and points spent refresh on their own, and the entries list shows each viewer with their tickets, badges and watch time.

Keyword entry is the pack’s Enter with the keyword flow, and Claim with the confirm word handles the confirm word. Both start on the Giveaway chat trigger, whose When field picks the keyword, the confirm word or either. Nothing else in chat reaches that trigger, so a flow of your own on it only ever runs for an open giveaway’s keyword or a winner’s confirm word.

The Giveaways page tells you when that is the case: with no entry flow on, a Giveaway flows row under the page title says Viewers can’t enter your giveaways from chat yet. Press Add on it. The Giveaway pack’s review opens on the right of the page, and its button says how many flows arrive, all paused. Press it: the review turns into Added — paused and Set it up. Close the panel, and the row now says the flows are paused: press Switch on, or Open flow to look first. A paused entry flow of your own is named instead, with Open flow and Switch on, so you never end up with two.

A refusal is said back to the viewer in the giveaway’s own words — not following, the wrong role, too little watch time, not enough points, or already holding every ticket they can. If chat says nothing at all, the keyword flow is usually paused or was never installed: the Chat card on the Entering step says which, and the last section covers the rest.

3. Close it and draw a winner

Everything about the giveaway is on one page: the rules on the left, what it is doing right now in the Run panel on the right. Once it has started, the rules read as sentences rather than a form.

1. Press Close to stop entries, or Close and draw to do both at once. Entries stop the moment either is pressed.
2. The Draw button fills the empty winner slots at random. It closes an open giveaway first, so it is always safe to press.
3. Each winner appears as a Winner slot card with their avatar, tickets and a countdown for the confirm window. Chat hears who won from the pack’s announcement flow.
4. A winner types the confirm word to claim. You can also press the tick icon (Confirm) on the slot yourself — that is what to do when the prize was handed over on stream.
5. Press the circular-arrows icon (Reroll) on a slot to replace that winner with a fresh draw from everyone who has not won yet. The slot card shows the replacement.
6. When every slot is confirmed the giveaway reads Finished. Press Archive to file it away under the collapsed Archived shelf.

When a confirm window runs out and the giveaway is set to draw a new winner when it does, that slot is redrawn on its own and the card shows the new winner.

4. Run it from chat

Moderators can drive the whole giveaway from chat. Each command is its own flow, named for what it does — Open a giveaway, Close a giveaway, Draw a winner, Reroll a winner, Confirm a winner, Cancel a giveaway and Giveaway status — so you can change one, or switch it off, without touching the rest.

Making and editing the giveaway on Giveaways needs the dashboard, so that part is yours or an editor’s. A moderator you have ticked on Team can run a giveaway you already made from its page too — open, close, draw, reroll and end — without seeing any prize code; the rest of your moderators work from chat. Share the work with mods and editors covers who can do what.

An operation on a giveaway that is not in the right state says why in chat. !giveaway cancel is quieter: only the broadcaster can call a giveaway off, and it does nothing at all for anyone else — no chat line, so it reads the same as a typo to a moderator who tries it.

5. Put the moments on stream

The Giveaway pack also shows three giveaway moments on your overlay as alerts: the giveaway opening, a winner being drawn, and a winner confirming. Each is its own flow, and each plays the alert design it names: Giveaway opened alert plays your giveaway-open alert design, Giveaway winner alert plays giveaway-winner, and Giveaway claimed alert plays giveaway-claimed.

1. Add the Giveaway pack from Flows → Add if it is not in your Flows list yet.
2. The pack adds a Giveaway alerts overlay with one alert layer for each moment, and puts the three designs in your draft (a design you already have by that name is kept). Publish in Studio so they show, then add the overlay’s URL to OBS from Set it up. To show them on an overlay you already use instead, add a Custom alert layer for each moment there and rename its design to the name that flow uses.
3. Open Giveaway opened alert, Giveaway winner alert and Giveaway claimed alert and enable the ones you want.

Each of the three starts on the Giveaway changes trigger, with its When field set to It opens, A winner is drawn or A winner confirms. A flow of your own on that trigger can react to any other moment too — Someone enters, Entries close, A claim runs out, A slot is redrawn — and Only this giveaway narrows it to one giveaway.

A missing design is not an error: the run continues, nothing is shown for that moment, and the run log says which design name it wanted. Arranging your overlay covers placing alert layers, and Add an overlay to OBS covers putting the overlay in OBS.

6. Put the giveaway panel on stream

Chat runs the giveaway; the Giveaway widget is where viewers watch it. One panel follows the giveaway you are running and shows the prize and its cover art, the keyword, how many entries are in, the last few people who entered, and the draw itself.

1. Open Overlays and press Browse templates (New overlay makes an empty one instead). There are two giveaway overlays: Giveaway panel, a corner card, and Giveaway: Big reveal, a wider one that draws the draw out longer and lists more entrants.
2. Press Add on the one you want, read its review and press Add. A Giveaway layer on an overlay you already have comes from Add on the left of the editor instead. Press Publish to put it on stream.
3. Give the prize a picture on the Giveaways page: Cover art is on the giveaway's Prize step. Press Choose picture or Upload there. It is optional, and setting it needs no Twitch permission.
4. Copy the widget’s OBS URL and paste it into an OBS Browser Source, 1920 × 1080 with a transparent background — the same as any other widget.
5. Open the giveaway. Everything else on the panel follows from the record: the keyword, the entry count and the last few entrants appear as chat enters.

While entries are open the panel counts down to the close time you set, or reads Entries open when the giveaway has no scheduled close. A giveaway that is still a draft draws its card with Not open yet, and nothing at all is drawn once one finishes or is called off.

Then the draw. Press Draw on the giveaway (or Close and draw, or !giveaway draw in chat) and the panel takes over: each winner slot spins in turn and lands with that winner’s name and their confirm window counting down beside it. Redrawing a slot spins that slot again with the fresh draw.

Use the roomier Giveaway 2 design. Select your Giveaway layer, open Content, and look for New look available. Press Preview new look to see it on the canvas, then Use new look and Publish to put it on stream. Your giveaway settings are carried over. The new design groups the prize and optional cover art, gives the entry keyword its own space, and shows each winner in a card with a confirmation ring.

The design follows your overlay's theme, including its font, colours, corners, spacing and backgrounds. In Parts, Winner card styles the cards and Winner status styles the confirmation and outcome text. A Minimal theme leaves the stream visible behind the content. Show the entry keyword, Show how many have entered, Show the latest entrants and the other Content switches still choose what appears.

Draw with a wheel instead. Select the Giveaway layer in the widget editor, open Content, and set Draw style to Wheel, then Publish. Each winner is then revealed on a spin wheel of the entrants, one segment each and sized by how many tickets they hold. With more than 24 entries the wheel shows the winner and 23 other entrants picked at random, and says Drawing from and the number of entries under it. The winner is drawn from every entry either way — the wheel only shows the draw, it never changes who wins — and each slot's wheel spins for at least 3 seconds. Slot reel puts the rolling names back. For a wheel of your own segments rather than your entrants, see Spin a wheel on stream.

What you should see

• The heading Giveaway, the prize, and optional cover art when the giveaway has one.
• The keyword, the entry count and the last few entrants, updating as chat enters.
• A countdown to the close time while entries are open, or Entries open when there is none.
• At the draw: the reel (or, with Draw style set to Wheel, a wheel of the entrants) spinning per slot, then each winner with their own confirm countdown.
• Nothing at all once the giveaway finishes or is called off — the panel clears rather than freezing on the last winner.

If something looks wrong

• The card reads Not open yet: the giveaway is still a draft. Open it on the Giveaways page.
• The card reads No giveaway right now: there is nothing to show, because no giveaway has been created on the channel yet.
• The card reads Entries closed — drawing next: entries have stopped and the draw has not run yet. Press Draw on the giveaway.
• No cover art: the giveaway has none, or the file it used has been deleted from your media library. A missing file draws no art rather than a broken picture — pick another under Cover art on the Prize step.
• The panel is showing a different giveaway: two are running, and it follows the one you opened most recently. Run one at a time.
• The panel cleared in the middle of a stream: the giveaway finished, or someone called it off. Points spent on tickets go back to their viewers — see the note under step 3.
• Nothing is drawn at all: the layer may be hidden in the widget editor, or the Browser Source may not be in a visible scene.
• A cover image will not delete from the media library: a giveaway still points at it, and the message names the giveaway. Change or clear its Cover art first, then delete the file. Once a giveaway has started its rules are fixed, so archive it instead: an archived giveaway lets go of its cover art, and the file can then be deleted.

7. Let viewers enter from the web

A giveaway can also take entries from its own public page, so viewers who are not watching chat right now can still enter — good for a giveaway that runs over hours or days. Every plan includes it; your plan lists it as Web entry.

1. Open the giveaway, go to its Entering step, and under Where do people enter? tick the Web card beside Chat. Both can be on together, or Web alone; at least one stays ticked.
2. Turning Web on moves How does the winner get it? on the Prize step to Claim page — a web winner may never be in chat, so the prize has to reach them somewhere they can sign in and claim it. Stock a prize for every winner there; Give away game keys and prizes covers stocking prizes and what a winner sees.
3. If the Winner step was set to Say a word in chat, it changes to Claim it on the page — a web winner cannot be asked to type a word in chat, so claiming is confirming. No confirmation is the other choice.
4. Once Web is on, its card shows the giveaway's Public page link: bloopbot.com/c/<your channel>/giveaways/<slug>. Share it however you like — a panel link, a chat command, your stream description. Every web giveaway is also listed at bloopbot.com/c/<your channel>/giveaways, so viewers can find it without the direct link. Your channel's home page, bloopbot.com/c/<your channel>, shows the giveaways open now at the top, with a tab bar to the full list, your store, a winner's prizes, your full Twitch bio and your own links.

What a viewer sees. The public page lists every giveaway currently open or scheduled, then up to five recently finished ones with their winners.

Opening one giveaway shows the prize, who can enter, and its own Take part panel:

1. Sign in with Twitch — the same identity-only sign-in the claim page uses. Bloopbot only sees their Twitch name.
2. Signed in, they see the same Take part panel. When tickets cost points, the button names the price — Enter giveaway (100 points), say — and the Who can enter facts above it say Free to enter when they don't.
3. After entering, the panel shows You're in with N tickets and, while under their limit, a way to add more.

A giveaway limited to subscribers or VIPs checks that through Twitch rather than a chat badge, since a web entrant sends no chat message to read one from. If the channel's Twitch connection cannot answer that question right now, the Entering step warns Reconnect Twitch to limit a web giveaway to subscribers or VIPs beside the role chips, and Review lists it under Before it can open — and the giveaway refuses to open until it can check. Open Settings › Connections and follow a re-authorisation prompt if one is shown; Troubleshooting covers reconnecting in full.

Long-running giveaways work the same way as any other: choose On a schedule on the Winner step and set Opens and Closes, and it is listed from the moment it has an opening time, showing Opens in … until then and a closing countdown once it is running — so a giveaway can sit on the page for days before or after you are live.

Close or archive several at once

1. On the Giveaways list, tick each giveaway you want, or tick Select all shown.
2. Hold Shift and tick another row to take every row between the two. Rows in a folded Archived shelf are never included.
3. In the bar that appears at the bottom of the list, press the padlock icon (Close entries) to stop entries on the picked giveaways that are Open, or the archive icon (Archive) to file away the picked ones that are Finished or Called off. Hover an icon to see how many giveaways it will change; the others, such as a Draft, are left as they are.
4. Press the cross icon (Clear selection) to untick everything.

If a giveaway cannot be changed, the bar says why and keeps it ticked; the rest are changed and the list updates.

A worked example: Friday key drop

Two winners, a follow lock, tickets that cost points, and a minute to claim.

1. Create the giveaway. On Prize: What are you giving away? Friday key drop, Number of winners 2, In chat.
2. On Entering: Keyword lucky, tick Followers only and leave the roles clear; under Tickets and points, Ticket cost 100, Max tickets each 5, and First ticket is free on.
3. On Winner: Say a word in chat, word !claim, 60 seconds, with If they don’t confirm in time, draw someone else on, and I’ll open and close it myself. Check Review, Save, then press Open. Chat reads 🎉 Friday key drop is open! Type lucky to enter.
4. A viewer types lucky: their first ticket is free and they are in. A second viewer types !enter 5 and is charged for five tickets. A viewer who does not follow you is told they need to follow to enter.
5. Press Close and draw. Two winner cards appear, chat says who won and asks each of them to type the confirm word, and the cards count their windows down.
6. One winner types !claim inside their window; chat confirms them. The other lets the window run out, so that slot is redrawn and the card shows the replacement, who then types the word.
7. When both are confirmed the giveaway reads Finished. Press Archive.

What you should see

• On Giveaways: a Drafts section holding the giveaway before you open it, then Open with the entry count and the keyword it answers to, then Finished, and Archived as a shelf you can show and hide.
• In chat while it is open: the opening line from the pack, one entry per viewer who types the keyword, and a refusal said back to anyone who cannot enter.
• On the run panel: the entry count and the points spent, every entry with its viewer’s tickets and badges, and one card per winner slot with its countdown.
• On Flows → Run log: a run for the keyword or !enter — carrying the refusal reason when one happened — and a run for each !giveaway command a moderator typed.
• Nothing at all in chat until you press Open: a draft is invisible to viewers.

Troubleshooting

• Typing the keyword does nothing: open the giveaway's Entering step and read the status under the Chat card. Paused — nobody can enter from chat or No flow enters people from chat yet means no flow is doing the entering — follow Open flow and switch it on, or add them from the Giveaway flows row on the Giveaways page. If the card says Live, the giveaway is still a draft or the word typed is not the one on the record: check the badge and keyword on the page.
• Nothing happens for one particular word: only one open giveaway can hold a keyword, so another open giveaway in the channel may own that word.
• A viewer cannot enter and chat does not say why: the refusal line is a connection in the flow. Open the keyword entry flow and check that the enter node’s rejected output is wired to a chat message.
• Drawing reports nothing to draw from: nobody entered while it was open. A redraw only replaces a winner who already exists, so create a new giveaway for another draw.
• A viewer types the confirm word and nothing happens: first check the status under Say a word in chat on the Winner step — the confirm flow has to be Live. Then, the word has to match the record’s Confirm word exactly, be typed inside the countdown, and come from the winner the slot is waiting on. The slot card shows which state that winner is in.
• Drawing more than one winner is refused: check that your plan lists Multi-winner giveaways as included, or set Number of winners to one on the Prize step.
• The overlay shows nothing at a giveaway moment: no alert layer on your overlays shows the design the flow asks for, or that design does not exist. The run log says which name it wanted.
• Chat never says who won: the winner announcement and the confirm-word flow are separate flows of their own — the announcement runs on the draw, and the confirmation line only after a winner types the word. Check both are installed and live.
• The public giveaway page says Not found: the giveaway is a draft with no Opens time set, or Web is not ticked under Where do people enter? on the Entering step — either way the page treats it exactly like an unknown link. Set an opening time or open it yourself, and check Web is on.
• A web giveaway won't open: check that your plan lists Web entry as included, or, for one limited to subscribers or VIPs, the channel's Twitch connection needs reconnecting so it can check that role; see the note under Let viewers enter from the web.