Giveaways

The Giveaway module lets moderators create timed giveaways with optional entry requirements. Members enter by reacting to the giveaway message, and winners are automatically picked when the timer ends.

Quick Reference

Command	Description	Permission	Cooldown
`.giveaway start`	Create a new giveaway	Moderator	3s
`.giveaway end`	End a giveaway early	Moderator	3s
`.giveaway reroll`	Re-pick winners	Moderator	3s
`.giveaway list`	List active giveaways	Moderator	3s
`.giveaway delete`	Delete a giveaway	Moderator	3s

Aliases: gw, g

Creating a Giveaway

.giveaway start <duration> <winners> <prize> [--channel #ch] [--role @role] [--level N]

Parameters:

duration — How long the giveaway lasts (e.g., 1d, 12h, 30m, 1w). Maximum: 30 days.
winners — Number of winners to pick (1-20).
prize — The prize description (up to 256 characters).

Flags:

--channel <#channel> — Post the giveaway in a different channel (defaults to the current channel).
--role <@role> — Require entrants to have a specific role.
--level <N> — Require entrants to be at least level N in the leveling system.

Examples:

.giveaway start 1d 1 Nitro Classic
.giveaway start 12h 3 $10 Gift Card
.giveaway start 1d 1 Custom Role --role @Level 10
.giveaway start 6h 2 Spotify Premium --channel #giveaways --level 5

Managing Giveaways

End Early

End a giveaway before its scheduled time. Winners are picked immediately.

.giveaway end <messageId>

The messageId is the ID of the giveaway embed message in the channel.

Reroll Winners

Re-pick winners for an already-ended giveaway. Useful if a winner does not claim their prize.

.giveaway reroll <messageId> [count]

If count is not specified, the original winner count is used.

List Active Giveaways

View all running giveaways in the server.

.giveaway list

Delete a Giveaway

Remove a giveaway entirely, including the Discord message and database record.

.giveaway delete <messageId>

Full Examples

.giveaway start 1d 1 Nitro Classic
.giveaway start 12h 3 $10 Gift Card
.giveaway end 123456789012345678
.giveaway reroll 123456789012345678
.giveaway reroll 123456789012345678 2
.giveaway list
.giveaway delete 123456789012345678

How It Works

A moderator creates a giveaway with .giveaway start.
The bot posts an embed in the target channel with the prize, duration, and entry instructions.
Members react to the embed to enter the giveaway.
When the timer expires (or the giveaway is ended early), the bot randomly picks winners from valid entries.
The embed is updated to show the winners, and the winners are mentioned in a follow-up message.

If a giveaway has role or level requirements, entries are validated at the time of winner selection. Members who no longer meet the requirements when the giveaway ends are excluded.

The number of active giveaways is limited based on your server's premium tier. Free servers can have fewer concurrent giveaways than premium servers.

Giveaways

On this page