Giveaway Campaigns

The Giveaway Campaigns module enables users to 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}]

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.

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 prize:Server Boost duration:2d

/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 completely 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 will also keep track of former winners and previous rerolls to make sure that the new winners weren't already picked in a previous iteration 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.