Where things are in the menu
The service's menu is Home and Winners, then New giveaway and Templates, then History and Settings. "Find a setting" at the top of the menu finds any setting by name, the old names included.
1. Turn on Giveaways
On the Services page, switch on the Giveaways card, then click Open.
If the service is off
Until it is on, /giveaway create answers "The Giveaways service is switched off in this server." If you have Manage Server, a button under that answer switches it on.
2. Run setup
On Settings, the last card is Setup. Click Run setup to pick or create the giveaway channel and find the host role.
What setup changes
- Before you press Run setup, the card says what a run would change.
- Setup keeps the giveaway channel picked on the page. If none is picked, or the picked one is gone or closed to the bot, it uses a channel named #giveaways.
- When there is no #giveaways, it creates one: everyone can read and react there, and writing is left to the bot.
- When setup creates the channel, it posts a short "Giveaways are live!" welcome there and tries to pin it. Pinning needs the Pin Messages permission.
- Nothing else on the page changes.
How setup finds the host role
Setup keeps the role picked under "Who can run giveaways from Discord". With none picked, it takes the first role whose name contains one of these words. They are tried in this order: giveaway host, giveaways, giveaway, event host, moderator, mod, staff and admin.
Case does not matter, and roles that a bot or an integration manages are skipped. Without a match, only people who can manage the server run giveaways from Discord.
3. Check the basics
The basics card on Settings holds the giveaway channel, who can run giveaways, how people enter and the time zone.
What each basic does
- The giveaway channel: the builder starts with it picked, and
/giveaway createposts where it is typed. - Who can run giveaways from Discord: people who can manage the server always can. On the dashboard, your Access roles decide.
- How people enter a new giveaway, with its reaction emoji (🎉 to start with).
- The time zone: it follows the server's time zone from the Bot Settings page, or you pick "Use one just for giveaways". Until the server has a time zone, giveaways use America/New_York. See the server time zone.
Under "More starting points" are "New giveaways allow drawing again" and "New giveaways get a Watch live page", both on to start with.
4. Optional: set the fair play rules
The Fair play card on Settings keeps past winners from winning again and holds the blocked list.
The fair play settings
- "Someone who won a giveaway here sits out the next" takes a number of days: 0 turns it off, and the most is 365.
- You also set the number a new giveaway's own wait starts with (7 days to start with). The longer of the server's wait and a giveaway's own wait counts.
- "Roles that skip the entry rules" skip what a giveaway asks under Who can enter. They never skip the blocked list, the wait, things to do or an invite minimum.
- "Blocked from giveaways" lists everyone blocked. Block someone takes a role or a member, by name or Discord user ID.
Your own replies
The What the bot says card holds the server's own replies for when someone enters, when someone cannot enter and the winner's DM.
5. Make a giveaway
Click New giveaway and start blank, from a quick start or from a template. Fill in the four steps, then click Post it now or Save draft.
The four steps
The quick starts are Quick giveaway, First come, first served and Every week. The post appears beside the four steps as Discord will show it.
- "What are you giving away?": the prize and how many win it, a headline and a few words under it. "Add a 2nd prize" adds more, up to 20 prizes.
- "When and where?": the channel, when "It starts" (right away or at a set time) and when "It ends". It ends on a date or after a while: 1 hour, 24 hours, 3 days, 7 days or a length you type (at least 30 seconds).
- "How do people enter?": Enter button, A reaction, Either one or First come, first served, with the emoji to react with.
- "Anything else?": one line each for Who can enter, Extra chances, Invite friends, Things to do, Prize codes, After the draw, Look, What the bot says and Repeat. After the draw holds Winners have to claim, a role for the winners, You can draw again and Watch live page.
Posting and saving
- When the giveaway starts at a set time, the button reads Schedule it instead of Post it now.
- The bot posts within a few seconds.
- Save as a template keeps it to start from again.
6. Optional: make one from Discord
In the channel where the post should appear, run /giveaway create with a title, a duration and a prize. You need Manage Server or the host role. See /giveaway create.
Options and the reply
durationis a length such as30m,2hor1d.- For the prize, give either a
prizewithwinners, ortierssuch as1:1:RTX 4090|2:2:$50 card. - Set
dropto make it first come, first served. - The reply is "✅ Giveaway #12 started. Watch live page: ...", without the link when the server's new giveaways get no Watch live page.
7. Let members enter
Members react with the emoji or press Enter. The post keeps a running count of entries.
What members see
| When | What happens |
|---|---|
| A member presses Enter | The reply "🎉 You're entered!", or the reason they were turned away |
| They press it a second time | The reply "You're already entered. Good luck!" |
| They press Leave | The reply "You've left the giveaway." |
| A reaction entry is accepted | Nothing: reaction entries are silent |
| A reaction entry is refused | A DM starting "Giveaway entry rejected:" |
| Someone reacts while entries are closed | No DM |
Removing the reaction takes the entry back. Text you wrote under What the bot says replaces "🎉 You're entered!" and the refusals, on the button and by DM.
The post and Home
- The post's footer keeps a running count ("Giveaway #12 · 40 entries").
- A Watch live link opens the giveaway's public page when it has one.
- Home shows each running giveaway with its clock and who is in.
8. Let the draw run
While the service is on, a giveaway ends on its own at its end time. To end it early, run /giveaway end with its number or click End now and draw on the giveaway's page.
How winners are drawn
- The bot checks about every 30 seconds for giveaways that reached their end time.
- Winners are drawn at random, weighted by extra chances. Past winners who sit out, anyone blocked and anyone who has left the server are left out.
- The results replace the post and ping the first 10 winners, with the best prizes first.
- Each winner is sent a DM.
When too few people can win
- With fewer people who can win than winners to draw, nobody wins: the giveaway is cancelled and a notice is posted in its channel.
- That count leaves out disqualified entries, past winners who sit out, blocked members and anyone short of invited friends.
- Someone who has left the server or holds a blocked role is only skipped when picked, so a draw can end with fewer winners than planned.
- A giveaway that draws its winners one at a time is cancelled only when nobody won anything.
9. Draw again if you need to
To replace winners, click Draw again on the giveaway's page or run /giveaway reroll. This works for 30 minutes after the draw, or for the time set for that giveaway.
How long drawing again stays open
The time set for a giveaway can be anything from 1 minute to 30 days. Drawing again does not work when You can draw again is off.
Prizes nobody claimed
- A winner who had to claim and did not shows under Needs you on Home and Winners. They stay there for 30 days after their time to claim ran out.
- Draw someone else picks a new winner from the people who entered and have not won. Leave it keeps them listed.
- After those 30 days, both buttons stay on the giveaway's page.
- A cancelled giveaway offers only Leave it.
Winners and the giveaway's page
- Winners lists who won in the last 30 days and whether the prize reached them. Its search finds winners from any time.
- The giveaway's page also has the entries (add, remove, disqualify, download who entered), the prize codes, its setup and what happened.
If something goes wrong, see Troubleshooting.