Giveaways

Run reaction-based giveaways with requirements, bonus entries, rerolls, and winner roles.

Giveaways post a giveaway embed, collect entries via reactions, verify eligibility automatically when the timer expires, and announce the selected winners.

Staff members need Manage Channels to manage giveaways. Awarding winner roles requires the bot and runner to have Manage Roles.

Start a giveaway

/giveaway start duration:<string> winners:<integer> prize:<string> [channel:<channel>] [description:<string>] [hosts:<string>] [requiredroles:<string>] [roles:<string>] [voice:<string>] [minlevel:<integer>] [maxlevel:<integer>] [invites:<integer>] [messages:<integer>] [voicelevel:<integer>] [age:<integer>] [stay:<integer>] [color:<string>] [thumbnail:<string>] [image:<string>] [bonus_target:<mentionable>] [bonus_entries:<integer>]
/giveaway start duration:24h winners:2 prize:Discord Nitro channel:#giveaways requiredroles:@Member bonus_target:@Booster bonus_entries:2

If you omit channel, bored uses the configured default giveaway channel. If no default is configured, it sends to the channel where the command was invoked.

Giveaway parameters

Default channel

/giveaway channel channel:<channel>
/giveaway channel

Omit the channel parameter to clear the default giveaway channel.

Manage giveaways

/giveaway end message_id:<id>
/giveaway cancel message_id:<id>
/giveaway reroll message_id:<id> [winners:<count>]

Edit a giveaway

Modify properties of an active giveaway message without restarting it.

/giveaway edit message_id:<id> [prize:<string>] [duration:<string>] [winners:<integer>] [description:<string>] [hosts:<string>] [requiredroles:<string>] [roles:<string>] [voice:<string>] [minlevel:<integer>] [maxlevel:<integer>] [invites:<integer>] [messages:<integer>] [bonus_target:<mentionable>] [bonus_entries:<integer>]
/giveaway edit message_id:123456789012345678 prize:$50 Steam Card winners:3

Blacklists

Restrict specific members or roles from entering giveaways across the server.

/giveaway blacklist target:<member|role>
/giveaway blacklists

Running /giveaway blacklist on an already blacklisted member or role will unblacklist them.

Overview and cleanup

/giveaway list
/giveaway clear

/giveaway clear removes ended or cancelled giveaways from the stored registry.

On this page