Giveaways
A giveaway is a prize, a deadline and a list of people who entered. FlaviBot posts the message, counts the entries, draws the winners the second the timer runs out, and lets you reroll if a winner never shows up.
Giveaways are being rolled out gradually. If Giveaways is not in your
dashboard's Engagement section, and /giveaway answers that it is not
available, the feature is not enabled for your server yet.
Who can run one
Anyone with Manage Server or Administrator. You can also nominate manager roles on the dashboard's Giveaways page, under Settings: members holding one of those roles can create, edit, end, reroll and delete giveaways without any Discord permission.
Starting one
The fastest way is one command:
/giveaway start duration:2d winners:3 prize:Nitro
duration accepts a combination of weeks, days, hours, minutes and seconds
written together: 2d, 1h30m, 1w, 45m. It also takes an optional
channel, description, required_role and image.
/giveaway create opens a form instead, if you prefer filling in fields to
remembering option names.
The dashboard's Create button gives you the full set of options, including everything premium below.
The giveaway message
The posted message shows the prize as its title, when it ends as a live countdown, the number of winners, the host and the running entry count.
How members enter depends on the entry method you chose:
- Button: a
🎉 Joinbutton on the message. This is the default. - Reaction: members react to the message with 🎉.
Both kinds of message also carry a ⋯ button. Anyone can press it, but only a
giveaway manager gets action buttons in the panel that opens: end,
pause, resume and reroll, whichever apply to the giveaway's
current state.
When the timer runs out, the message is rewritten to show the winners, and a separate announcement mentioning them is posted in the same channel. If nobody entered, that is what the announcement says.
Managing a running giveaway
Except for /giveaway list, every subcommand in this table takes a reference, which is either the giveaway's id or the id of its message in Discord.
| Command | What it does |
|---|---|
/giveaway list | Lists the giveaways currently running |
/giveaway edit | Changes the prize, the winner count or the remaining time |
/giveaway pause | Freezes a running giveaway and blocks new entries |
/giveaway resume | Unfreezes it |
/giveaway end | Ends it now and draws the winners |
/giveaway reroll | Draws replacement winners, winners defaults to 1 |
/giveaway delete | Cancels it without drawing anything |
A reroll never picks someone who already won that giveaway.
Who is allowed to enter
Set on each giveaway, in the create form:
- Required roles, with a mode: the member needs any of them, or all of them.
- Blacklist roles and blacklist users, who can never enter this one.
- Bypass roles, whose holders skip every requirement check.
Two of those also exist server-wide, under Settings on the Giveaways page: a blacklist roles list that applies to every giveaway, and a bypass roles list that applies to every giveaway. The per-giveaway lists add to them rather than replacing them.
Order matters: bypass is checked first and wins, then the blacklists, then the required roles.
Premium options
The following are available from Silver upward. On a free server the controls are visible but locked, and the settings are ignored even if a value somehow got saved.
Advanced requirements add gates that are not about roles: minimum account age, minimum time in your server, minimum level, minimum message count, and server boosters only.
Bonus entries make some members count more than once. Each entry is worth 1 by default; you add extra entries for holding a role (these stack if a member holds several), for boosting the server, and per member they invited who is still around. More entries means more chances, not a guaranteed win.
Prize tiers and a claim window. Tiers split one giveaway into ranked
prizes: the first winners drawn get the first tier's prize, the next ones the
second tier's, and so on, with the winner count derived from the tiers. A
claim window makes winners press a 🎁 Claim button within a number of
minutes; a winner who does not claim in time forfeits and a replacement is
drawn automatically.
Scheduled start and recurring giveaways. A scheduled giveaway is created now and posts itself later, with the countdown starting then. A recurring giveaway starts a fresh one from a saved template on a repeating schedule.
Templates save a giveaway's whole configuration so you can apply it to a new giveaway in one click, and they are what a recurring giveaway is built from.
A public entry page publishes a web page for the giveaway so people can enter from a browser as well as from Discord, with an optional captcha check.
Analytics break down entries, which requirements filtered people out and where bonus entries came from, with a CSV export.
Limits by tier
| Free | Silver | Gold | Platinum | |
|---|---|---|---|---|
| Giveaways running at once | 5 | 25 | 50 | Unlimited |
| Saved templates | 0 | 5 | 15 | Unlimited |
| Bonus-entry role rules per giveaway | 0 | 10 | 20 | 30 |
Scheduled giveaways do not count toward the running limit until they actually start.
Direct messages to winners
DM the winners is a switch on the create form and it is off by default. Turn it on and each winner also gets a direct message on top of the public announcement. Members with DMs closed simply do not get one.
Permissions
In the giveaway channel the bot needs View Channel, Send Messages and Embed Links. Reaction giveaways also need Add Reactions.
