Community & management
Giveaways
Run contests with a single command: members enter with one click, and Ganyu draws the winners automatically right on time. Management requires the Manage Server permission.
By the Ganyu team Updated on
Commands
The message_id is the ID of the giveaway's announcement message (right-click → Copy Message ID, in developer mode).
/giveaway create <prize> <winners> <duration> Starts a giveaway with button entry. winners: 1 to 20 winners; duration: duration in minutes (1 to 10080, i.e. 1 week maximum).
/giveaway end <message_id> Ends a giveaway early and immediately draws the winners.
/giveaway reroll <message_id> [winners] Draws new winners for a finished giveaway (winner count optional).
Entry conditions and bonuses
Beyond the quick command, you can configure giveaway templates with entry conditions and bonuses:
- Minimum account age (up to 365 days) to block brand-new accounts.
- Minimum server tenure (up to 365 days).
- Blacklisted roles: holders can't enter.
- Bonus roles: certain roles grant extra entries (multiplier up to ×10), ideal for rewarding your boosters or subscribers.
- DM winners and mention winners on the announcement, which can be toggled on or off.
Tip — Combine a bonus role with an Automatic roles & welcome or Premium role to give your most loyal members better odds.
Limits and tracking
Each giveaway's participant list can be viewed in the The web dashboard. Draws run automatically when they expire, even after the bot restarts.
| Limit | FREE | PREMIUM | PRO |
|---|---|---|---|
| Active giveaways | 5 | 15 | 100 |
| Maximum duration | 7 days | 30 days | 1 year |
| Winners per draw | 20 | 50 | 1000 |
Frequently asked questions
How do members enter?
By clicking the button on the announcement message. No reaction or command is needed; the click enters them instantly.
Does the giveaway keep running if the bot restarts?
Yes. Giveaways are persisted and the automatic draw fires at the scheduled time, even after a restart.
A winner doesn't claim their prize, what should I do?
Use /giveaway reroll <message_id> to draw one or more replacements from the remaining participants.
Can I give some members better odds?
Yes, via bonus roles: a role can grant up to 10 extra entries. You can also require a minimum account age or tenure, and blacklist roles.
How many giveaways can I run at once?
5 on FREE, 15 on PREMIUM, 100 on PRO, with a maximum duration of 7 days, 30 days or 1 year depending on the tier. See Premium.
How do I start a giveaway in one command?
/giveaway create <prize> <winners> <duration> posts the announcement with its entry button. winners accepts 1 to 20 winners and duration is in minutes, from 1 to 10,080, which is one week at most on FREE.
Who can create a giveaway?
The Manage Server permission is required to create, end or reroll a draw. Members need no particular permission to enter.
Can I reserve a giveaway for established members?
Yes. A giveaway template can require a minimum Discord account age and a minimum time on the server, each up to 365 days, which rules out accounts created for the occasion.
Can I exclude some members from the draw?
Yes, with blacklisted roles: anyone holding one of those roles is refused entry. It is the usual setting for sanctioned members or for staff.
Are winners notified automatically?
Two independent options exist: a direct message to each winner and a mention of the winners in the announcement. You can turn on either or both.
How do I end a giveaway early?
/giveaway end <message_id> closes the draw immediately and picks the winners. The id is the one of the announcement message, copied with a right click in developer mode.
Sources and official documentation
Community & management
Ready to try Ganyu?
Add Ganyu to your Discord server for free and put this guide into practice in under a minute.
Add Ganyu for free