Giveaway Campaigns
The Giveaway Campaigns module lets users start and manage giveaways in a Discord server.
Note
The duration option below takes the standard time code (e.g. 1d3h2m) - or a Discord timestamp mention referring to a future time - described in Time Format Code.
/giveaway start
Command Syntax
/giveaway start [channel:{channel}] prize:{prize name} duration:{time code} [winners:{1-30}] [max_entries:{number}] [role1:{role}] [role2:{role}] [role3:{role}] [exclude_role1:{role}] [exclude_role2:{role}] [exclude_role3:{role}] [header:{text}] [ping_role:{role}] Command Description
Starts a new giveaway in the given channel or thread. Members can participate by clicking on the reaction that is added by the bot.
If one or more role1/role2/role3 roles are given, the giveaway will only select winners among those participants that have at least one of the selected roles at the time of closure. Roles cannot be combined with max_entries - using both is rejected with an error, and max_entries (if given) must be at least winners.
header adds announcement text above the giveaway embed (max 1024 characters), and ping_role pings that role when the giveaway is posted. Only the pinged role is mentioned: the header text cannot ping anyone else, and the prize cannot ping anyone at all.
exclude_role1/exclude_role2/exclude_role3 work the opposite way: any participant holding any of those roles is skipped when winners are drawn. They are independent of the required roles and can be combined with max_entries. Both filters are evaluated when the campaign ends, not when someone reacts - so losing a required role, or gaining an excluded one, before the end changes eligibility.
winners defaults to 1 if omitted (max 30).
Note
channel is optional and defaults to the channel the command was used in; it also accepts threads. prize and duration are required. Role restrictions are up to 3 separate role1/role2/role3 options instead of an open-ended role list.
Note
Users must still be members of the server at the time of the giveaway campaign end for them to be rolled as winners. Users that are not in the server when the campaign ends will not be considered. Bots reacting to the giveaway campaign will always be ignored.
Permissions Needed
- User: Manage Server by default (server managers can authorize additional roles/users from the server's Command Permissions page on the dashboard - see the Permissions System)
Examples
/giveaway start channel:#giveaways prize:Free Steam Key duration:1w winners:2 /giveaway start channel:#giveaways prize:Blue Hat duration:3d winners:5 role1:@BluePeople role2:@WearingHats /giveaway start channel:#giveaways prize:Free Steam Key duration:1w winners:2 exclude_role1:@Staff exclude_role2:@Bots header:Good luck everyone! ping_role:@Giveaways /giveaway start prize:Server Boost duration:2d
Confirming a giveaway in a specific channel
Note
When channel is given explicitly, nothing is posted straight away.
The bot replies privately with a preview of exactly what will be posted (channel, prize, duration, winners and entry rules) and two buttons, Start giveaway and Cancel. If that channel already has an ongoing giveaway, the preview says so before you commit to running a second one at the same time.
The preview expires after 5 minutes; if it does, run /giveaway start again. Starting without channel (in the current channel) posts immediately.
/giveaway edit
Command Syntax
/giveaway edit [message_id:{id}] Command Description
Opens an editing form for an existing giveaway in the current channel. The message ID is optional: if omitted, the most recent ongoing giveaway in the channel will be considered.
You cannot edit a giveaway's duration, channel, restricted roles, or max_entries.
Permissions Needed
- User: Manage Server by default (server managers can authorize additional roles/users from the server's Command Permissions page on the dashboard - see the Permissions System)
Examples
/giveaway edit /giveaway edit message_id:123456789098765432
/giveaway end
Command Syntax
/giveaway end [message_id:{id}] Command Description
Immediately ends a giveaway and picks a winner (or more winners) among those that participated. The message ID is optional: if omitted, the most recent ongoing giveaway in the channel will be considered.
Side note: You can abort a campaign by deleting the campaign message that the bot sent.
Permissions Needed
- User: Manage Server by default (server managers can authorize additional roles/users from the server's Command Permissions page on the dashboard - see the Permissions System)
Examples
/giveaway end /giveaway end message_id:123456789098765432
/giveaway reroll
Command Syntax
/giveaway reroll [message_id:{id}] [winners:{1-10}] Command Description
Picks one (or more, if winners is used) new winner(s) for an already ended giveaway. The message ID is optional: if omitted, the most recently ended giveaway in the channel will be considered.
You can only reroll up to 10 winners per command run.
This command will not overwrite the existing winners in the original message. It also tracks former winners and previous rerolls, so a new winner is never someone already picked in an earlier run of the command.
Note
Users must still be members of the server at the time of the giveaway campaign reroll for them to be rolled as winners. Users that are not in the server when the campaign is rerolled will not be considered. Bots reacting to the giveaway campaign will always be ignored.
Permissions Needed
- User: Manage Server by default (server managers can authorize additional roles/users from the server's Command Permissions page on the dashboard - see the Permissions System)
Examples
/giveaway reroll /giveaway reroll message_id:123456789098765432 winners:5
/giveaway list
Command Syntax
/giveaway list
Command Description
Lists all ongoing giveaways in the current server.
Permissions Needed
- User: Manage Server by default (server managers can authorize additional roles/users from the server's Command Permissions page on the dashboard - see the Permissions System)
Examples
/giveaway list
Giveaway Reaction Emoji
Note
Setting a custom reaction emoji for giveaways in a server is configured from the server's Settings page on the dashboard.
See also
Full migration mapping for these commands: Migration Guide.