Giveaways

Overview

Giveaways support a claim window so a winner has to actually accept the prize, not just be picked and forgotten. Start one with a command or from the dashboard. Members enter with the button (or a reaction), and when it ends Petto draws the winners. With a claim time, a winner who does not press Accept in time loses the prize and a new winner is drawn. Every message can be your own text or a saved embed.

Entering

Accepting the prize

zoe_plays thanks everyone and Petto writes that zoe_plays accepted their win for the Steam gift card — In Discord: the winner presses Accept in time.

Starting one

!giveaway quick <duration> <winners> <prize> [channel]
!giveaway start <duration> <winners> <prize> [channel] [claim_time] [preset] [embed_template] [entry_mode]
!giveaway template <template_name> [channel]

!giveaway quick 1h 1 Nitro
!giveaway start 1d 3 Steam key --channel #giveaways --claim_time 5m --preset boosters

✅ Giveaway started in #giveaways for Nitro.

quick uses server defaults for everything else. entry_mode is button (default) or reaction. The prize can have several words without quotes: it takes everything after the number of winners, so the options after it go as flags (--channel #giveaways, --claim_time 5m, --preset boosters, --embed_template gw-card, --entry_mode reaction). The prize can have several words without quotes: it takes everything after the number of winners, so the options after it go as flags (--channel #giveaways, --claim_time 5m, --preset boosters, --embed_template gw-card, --entry_mode reaction).

!giveaway quick

!giveaway start

!giveaway template

From the dashboard

In the dashboard, Giveaways → Running giveaways has a form to start one (prize, winners, duration, channel, claim time, entry method, bonus-entry preset and design), a button to End now and, for the giveaways that ended, Draw again. Each running giveaway has an Edit button to change the prize, the number of winners and a new end (counted from now); what you leave empty stays as it is. It uses the same engine as /giveaway, so the result is the same. You need to manage the server.

Managing one in progress

!giveaway reroll <message_id> [winners]
!giveaway end <message_id>
!giveaway edit <message_id> [prize] [winners] [duration]

!giveaway reroll 123456789012345678
!giveaway edit 123456789012345678 --winners 5
!giveaway edit 123456789012345678 $10 NITRO / 1x DECO 1 30d

The prize can have several words and needs no quotes: it is everything between the message id and the numbers at the end. The last words that look like a duration (30d, 3d 4h) are the new end, and a number before it is the number of winners. --prize, --winners and --duration still work.

!giveaway reroll

!giveaway end

!giveaway edit

Server defaults

!giveaway embed <template>
!giveaway reaction <emoji>
!giveaway entry-mode <mode>

!giveaway reaction 🎉
!giveaway entry-mode reaction

!giveaway embed

!giveaway reaction

!giveaway entry-mode

!giveawayconfig shows these defaults and every giveaway command in one card. !giveawayconfig shows these defaults and every giveaway command in one card.

Custom messages

Every stage has its own configurable message. They all take the giveaway variables ({gw.*}) and the usual ones; {user} is the winner:

!giveaway winner-message <message>
!giveaway no-entries-message <message>
!giveaway deny-message <message>
!giveaway claim-time-message <message>
!giveaway claim-time-over-message <message>
!giveaway accept-message <message>

!giveaway winner-message "{user} won **{gw.prize}**!"
!giveaway no-entries-message "Nobody entered, no winner this time."

!giveaway winner-message

!giveaway no-entries-message

!giveaway deny-message

!giveaway claim-time-message

!giveaway claim-time-over-message

!giveaway accept-message

Each message can also be a saved embed instead of text:

Example

!giveaway message-template winner gw-winner
!giveaway message-template claim_time_over none

message is winner, deny, claim_time, claim_time_over, accept or no_entries, and none goes back to the text. See Saved Embeds Everywhere. deny-message fires when a winner denies their prize, no-entries-message fires when the giveaway ends with nobody entered, distinct from each other.

Examples

Winner
Claim reminder
No entries
Giveaway design

Command

!giveaway winner-message "🎉 Congrats {user}, you won **{gw.prize}**! DM {gw.host} to get it."

Result

🎉 Congrats @Liam, you won Discord Nitro! DM @Ana to get it.

The ended card with Winner(s): zoe_plays, then Petto: Congrats zoe_plays, you won the prize, DM chu to get it — In Discord: the winner message of the example, when a giveaway ends.

Command

!giveaway claim-time-message "{user}, you won **{gw.prize}**! Press the button within {gw.claim_time} to claim it ⏳"

Result

@Liam, you won Discord Nitro! Press the button within 10 minutes to claim it ⏳

Petto writes that zoe_plays won and has 10 minutes to press the button, then pings zoe_plays with Accept and Deny — In Discord: the claim reminder of the example.

Command

!giveaway no-entries-message "Nobody entered the **{gw.prize}** giveaway 😢 Better luck next time!"

Result

Nobody entered the Discord Nitro giveaway 😢 Better luck next time!

A saved embed for the giveaway message itself:

Commands

!embed create gw-card {embed}$v{title: 🎁 {gw.prize}}$v{description: {gw.entry_text}{newline}{newline}**Winners:** {gw.winners}{newline}**Ends:** {gw.ends}{newline}**Hosted by:** {gw.host}{newline}**Entries:** {gw.entries}}$v{color: #f0a88f}
!giveaway embed gw-card

Result

🎁 Discord Nitro
Click the button below to enter!
Winners: 3 · Ends: in 2 days · Hosted by: @Ana · Entries: 87

There is no member in the giveaway message itself, so use {gw.host} rather than {user}. With a bonus-entry preset, {gw.preset} lists the extra entries of each role.

Variable	What it gives	Example
`{gw.prize}`	The prize	Discord Nitro
`{gw.winners}` / `{gw.winner_text}`	Number of winners / the winners line	3 / 3 lucky winners!
`{gw.entries}`	Entries so far	87
`{gw.host}` / `{gw.host_name}`	The host	@Ana / ana
`{gw.ends}`	When it ends, relative	in 2 days
`{gw.claim_time}`	Time to claim (in the claim message)	10 minutes
`{gw.entry_text}`	How to enter	Click the button below to enter!
`{gw.status}`	`Active` or `Ended`	Active
`{gw.preset}`	Bonus entries of the preset	@Booster — +2 entries

All of them, with {gw.duration}, {gw.reaction} and {gw.entry_mode}, are in Variables.

Templates

Save a full giveaway configuration to relaunch later with !giveaway template.

!giveawaytemplate create <name> <prize> <winners> <duration> [channel] [claim_time] [preset] [embed_template] [entry_mode]
!giveawaytemplate edit <name> [prize] [winners] [duration] [channel] [claim_time] [preset] [embed_template] [entry_mode]
!giveawaytemplate remove <name>
!giveawaytemplate list

!giveawaytemplate create monthly-nitro Nitro 1 3d #giveaways

!giveawaytemplate create

!giveawaytemplate edit

!giveawaytemplate remove

!giveawaytemplate list

!giveawaytemplateconfig

Bonus-Entry Presets

Give certain roles extra entries automatically.

Overview

Guides

Concepts

Moderation

Automation

Community

Roleplay

Miscellaneous

Onboarding

Setup

Resources

Common Issues

Changelog

Overview

Starting one

From the dashboard

Managing one in progress

Server defaults

Custom messages

Examples

Templates

Bonus-Entry Presets

​Overview

​Starting one

​From the dashboard

​Managing one in progress

​Server defaults

​Custom messages

​Examples

​Templates

​Related

Bonus-Entry Presets

Overview

Starting one

From the dashboard

Managing one in progress

Server defaults

Custom messages

Examples

Templates

Related