$reward

$reward is a chat command for running channel-point reward giveaways. Moderators create a reward, viewers enter by redeeming it with channel points, and moderators draw and resolve winners.

Use $reward help in chat to get the public documentation link.

See the $reward changelog for public release notes.

How Reward Giveaways Work

A reward is a channel-point reward on Twitch or Kick. Once it is open, viewers enter the giveaway by redeeming it — spending their channel points. Each redemption becomes an entry.

• Entries stay pending (the points are spent but the redemption is not yet fulfilled) until the giveaway is resolved or the entry is refunded.
• An audience can be required: public (anyone), follower, or subscriber. Redemptions from viewers who don't meet the tier are automatically refunded.
• With --unique, each viewer can only have one standing entry; a duplicate redemption is refunded. A refunded or cancelled entry frees the viewer to enter again.

The moderator lifecycle is: create the reward → viewers redeem to enter → close entries → draw to pick winners → mark the winners → resolve. Resolving either fulfills the marked winners and cancels (refunds) everyone else, or fulfills everyone, depending on the reward's resolution mode.

You can also adopt an existing channel-point reward and manage rewards from the web dashboard; those flows are not chat commands. A reward whose redemptions are set to skip the request queue (auto-fulfill) cannot be managed, because the giveaway needs redemptions to stay pending so non-winners can be refunded.

Moderator Commands

All $reward subcommands require moderator (or broadcaster) permission. The reward UUID shown when a reward is created is the --id used by every other subcommand.

Create A Reward

$reward create --title Mega Drop --prompt Redeem to enter the drop --cost 500 --audience follower --unique --mode winners

Creates a channel-point reward and starts collecting entries. --title and --prompt are greedy — they collect every following non-flag word, so multi-word values need no quoting. --mode chooses how the giveaway resolves (see Options). The reply includes the reward's id.

Update A Reward

$reward update --id <uuid> --title New Title --prompt New prompt --cost 750

Changes the title, prompt, and/or cost of a reward that is still open or closed. Provide only the fields you want to change.

Pause / Unpause

$reward pause --id <uuid>
$reward unpause --id <uuid>

Pauses or unpauses redemptions on the platform without ending the giveaway. A paused reward is still shown but cannot be redeemed.

Close / Reopen Entries

$reward close --id <uuid>
$reward open --id <uuid>

close stops accepting new entries (the reward is disabled on the platform). open reopens a closed reward and collects entries again; reopening clears any previously marked winners so you can draw fresh.

Draw Winners

$reward draw --id <uuid> --target wheel

Generates a spin-the-wheel draw from the current pending entrants and replies with the wheel link. --target defaults to wheel. Drawing does not pick winners by itself — use winner mark to record who won.

Mark / Unmark A Winner

$reward winner mark --id <uuid> --redemption-id <redemption>
$reward winner unmark --id <uuid> --redemption-id <redemption>

Marks (or unmarks) a specific entry as a winner. In winners fulfillment mode, only marked winners are fulfilled on resolve. Use list participants to find redemption IDs.

List Winners / Participants

$reward list winners --id <uuid>
$reward list participants --id <uuid>

list winners shows the entries currently marked as winners. list participants reports the entry count.

Resolve

$reward resolve --id <uuid>

Settles a closed giveaway. In winners mode the marked winners are fulfilled and everyone else is cancelled (refunded); in everyone mode every pending entry is fulfilled. Resolution runs in the background.

Remove

$reward remove --id <uuid>

Deletes the reward from the platform. Any pending entries are refunded first. Removal runs in the background.

Options

Option	Used By	Meaning
--id <uuid>	every subcommand except create and help	The reward's UUID, shown when the reward is created.
--title <value>	create, update	Reward title. Greedy — multi-word values do not need quotes.
--prompt <value>	create, update	Reward prompt shown to viewers. Greedy like --title.
--cost <number>	create, update	Redemption cost in channel points.
--audience <public|follower|subscriber>	create	Minimum audience tier allowed to enter. Ineligible redemptions are refunded.
--unique	create	Allow only one standing entry per viewer.
--mode <winners|everyone>	create	Fulfillment strategy: winners fulfills marked winners and cancels the rest; everyone fulfills all pending entries.
--target <wheel>	draw	Draw target. Currently only wheel.
--redemption-id <value>	winner mark, winner unmark	The redemption to mark or unmark as a winner.

Notes

• Entries are reconciled against the platform whenever a giveaway is drawn, resolved, or synced, so a missed or out-of-order redemption webhook does not change the outcome — the platform is the source of truth.
• Channel points for pending entries are only returned when the entry is cancelled (on resolve in winners mode, or on remove). Fulfilled entries keep the points spent.