Giveaways

What it does

Giveaways let you run prize drops your members enter with a single button click. You set the duration, number of winners, and prize, and exceed handles entries, picks winners when time runs out, and lets you reroll or end early. Optional entry requirements keep giveaways fair — gate them behind a role, level, account age, or invite count.

Review active giveaways on the Giveaways dashboard page.

How to start one

Use ,giveaway start <duration> <winners> <prize> in the channel where you want it posted. For example:

,giveaway start 1h 1 Discord Nitro
,giveaway start 2d 3 $10 Steam gift card

Durations look like 30m, 1h, or 2d. The command alias is ,g, and ,gstart is a shortcut. All giveaway commands require Manage Server.

By default the giveaway is posted in the channel you run the command in. To post it somewhere else, mention the channel anywhere in the command, for example ,gstart 1h 1 Nitro #giveaways.

Members enter by clicking the join button on the giveaway message.

Entry requirements

You can restrict who enters by setting requirements inline on ,giveaway start / ,gstart <duration> <winners> <prize>, or from the giveaway form on the dashboard. Add any of these flags after the prize:

• --role @role — must have a specific role (alias --reqrole).
• --level <n> — must be at least this Leveling level (alias --reqlevel).
• --age <days> — account must be at least this many days old (alias --reqage).
• --invites <n> — must have at least this many total invites (alias --reqinvites).
• --newinvites <n> — must have at least this many new invites, counting only people they invited after this giveaway was created.
• --server <id> — must be in another server the bot is also in.
• --vc — must be in any voice channel, or --vc #channel to require a specific one.
• --vanity — must have the server vanity text in their custom status, using the Vanity Role text.

Example: ,giveaway start 1d 1 Nitro --level 10 --invites 5

--newinvites is built to reward real growth from the giveaway itself. It counts only members whose first-ever join to the server happened after the giveaway started, and it ignores fake invites and anyone who has since left. So someone who was already in the server, leaves, and rejoins does not count as a new invite.

All requirements you set are shown on the giveaway embed so members know what they need.

Live requirements

--vc and --vanity are checked continuously while the giveaway runs. If a member leaves the voice channel or stops repping the vanity before it ends, their entry is removed automatically, so only members who still meet the requirement at draw time can win.

Managing giveaways

• ,giveaway list — show active giveaways with entry counts and end times.
• ,giveaway end <id> — end a giveaway early and draw winners now. Shortcut: ,gend <id>. Alias: stop.
• ,giveaway reroll <id> — draw new winners for an ended giveaway, replacing all of them. Shortcut: ,greroll <id> (also aliased ,reroll). Add a count to reroll only some: ,giveaway reroll <id> <n> redraws just N winners, for example one winner of a three-winner giveaway. To swap one specific person, ,giveaway reroll <id> @user replaces that winner with a new random eligible entrant.
• ,giveaway delete <id> — delete a giveaway and its message. Aliases: remove, cancel.

You can reference a giveaway by its short id (from ,giveaway list) or by its message ID.