Docs / Guides / Run a giveaway members trust

Run a giveaway members trust

In short

You will have a giveaway with fair-play rules, a blocked list, a public Watch live page and a draw-again option if a winner does not claim.

Before you start: to test the entry at the end, you need a second account or a member to help.

1. Turn on Giveaways and run setup

On the Services page, turn on the Giveaways switch and click Open. On Settings, click Run setup in the Setup card.

What setup does

Setup picks or creates the giveaway channel (#giveaways if none is picked) and finds a host role by name. See Set it up.

2. Set the fair-play rules

On Settings, open the Fair play card. Set how many days a past winner sits out and add anyone who must not win to Blocked from giveaways.

Wait times, the blocked list and roles that skip the rules
  • Someone who won a giveaway here sits out the next takes 0 (off) to 365 days.
  • A new giveaway has its own wait too (7 days to start with). The longer of the two counts.
  • The blocked list takes a role or a member, by name or Discord user ID.
  • Roles under Roles that skip the entry rules skip the entry rules but never the blocked list, the wait, things to do or an invite minimum.

3. Choose who can run giveaways

In the basics card on Settings, pick the role under Who can run giveaways from Discord.

Who can run the commands

Members with Manage Server, Administrator or the host role can run /giveaway create, /giveaway end, /giveaway reroll and /giveaway cancel. Blocked list commands need more than the host role.

4. Build the giveaway

Click New giveaway and fill in the four steps: What are you giving away?, When and where?, How do people enter? and Anything else?

Prizes, entry and the extra options
  • You can add up to 20 prizes.
  • Entry can be the Enter button, a reaction, either one or first come, first served.
  • Anything else? covers Who can enter, Extra chances, Invite friends, Things to do, Prize codes, After the draw, Look, What the bot says and Repeat.
  • Turn on Winners have to claim their prize if you want proof the winner is still there.
  • You can draw again lets you replace winners for a while after the draw. Even with it off, a prize nobody claimed can still be drawn again.

5. Keep the Watch live page on

Under After the draw, leave Watch live page on.

What the Watch live page shows
  • It is a public page that shows people entering and plays the draw when time is up.
  • The post links to it as Watch live.
  • It stays up for 3 days after the end.
  • Things to do turn it on for that giveaway.

6. Post it

Click Post it now or Schedule it for a later start. The bot posts within a few seconds.

Drafts, templates and posting from Discord
  • Save draft keeps it unposted.
  • Save as a template keeps the setup to start from again.
  • You can also run /giveaway create in Discord for a quick one. See /giveaway create.

7. Let the draw run, then draw again if needed

The giveaway ends on its own at its end time and the bot DMs each winner. To replace a winner, click Draw again on the giveaway's page or run /giveaway reroll.

How winners are drawn and how long you can draw again
  • 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.
  • Drawing again works for 30 minutes after the draw unless you changed it (1 minute to 30 days).
  • A winner who had to claim and did not appears under Needs you, where Draw someone else picks a new one.

8. Check that it works

Enter your own giveaway with a second account or ask a member to press Enter. The member should see "🎉 You're entered!" and the post's entry count should go up.

Test the draw too
  • To test the draw, end a test giveaway with /giveaway end.
  • When a giveaway draws all its winners at once and fewer people can win than there are winners, nothing is drawn. The giveaway is cancelled with a "Not enough entries" notice.
  • See Troubleshooting.

Next

Was this page helpful?
YourBot docs Reference tables are generated from the code that is running. Ask in Discord