Giveaways

Overview

The giveaway system lets you host interactive giveaways in your server with reaction or button entry, role restrictions, entry multipliers, requirement gates (booster/VC/messages/invites), a blacklist, and fully custom embeds or containers for the giveaway message itself. Winners are selected automatically when the giveaway ends, and can be rerolled afterward.

Giveaways support two entry modes (reaction or button), two display styles (embed or Components V2 container), and can use a custom saved embed/container with giveaway placeholders instead of the default layout.

Setup

Before starting your first giveaway, run setup once per server to configure mode and style.

~giveaway setup

~gw setup

This opens an interactive panel where you can configure:

Mode — reaction (react with 🎉 to enter) or button (click a button to enter)
Style — embed or container (Components V2)
Custom Embed/Container — Use one of your saved embeds or containers as the giveaway message instead of the default layout
Requirements — Gate entry behind Booster status, being in a voice channel, a message count, or an invite count
Blacklist — Users or roles that can never enter giveaways in this server

You must run giveaway setup and set both a Mode and a Style before giveaway start will work.

Aliases: gway setup, gwy setup, gw setup
Permissions: Manage Server

Commands

giveaway start

Start a new giveaway in the current channel.

~giveaway start <duration> <winners> <prize> [role] [entry_role:entries]

~giveaway start 1d 2 Discord Nitro
~gw start 12h 1 $50 Gift Card @VIP
~gwy start 2d 3 Premium Role @Booster:3
~gw start 1w 5 Custom Role @VIP @Booster:2 @Supporter:5

Parameters:

duration — How long the giveaway runs (s/m/h/d/mo/y)
winners — Number of winners to select
prize — What the winners receive
[role] — Optional: restrict entry to members with this role
[role:entries] — Optional: give role holders multiple entries

Duration Format:

s = seconds
m = minutes
h = hours
d = days
mo = months
y = years

Entry Multipliers: Add @Role:number to give that role multiple entries:

@Booster:3 = Boosters get 3 entries each
@VIP:5 = VIP members get 5 entries each

Multiple multiplier roles can be stacked in one command. If a member qualifies for more than one, the highest multiplier applies.

giveaway setup must be completed first — start will refuse to run otherwise.

Aliases: gway start, gwy start, gw start
Permissions: Manage Server

giveaway end

End an active giveaway early and select winners.

~giveaway end <message_link>

~giveaway end https://discord.com/channels/123/456/789
~gw end https://discord.com/channels/123/456/789

Parameters:

message_link — Link to the giveaway message

What It Does:

Ends the giveaway immediately
Selects and announces winners
Removes reactions (reaction mode) or disables entry buttons (button mode)
Cannot be reversed, but winners can still be rerolled afterward

How to Get Message Link: Right-click the giveaway message → Copy Message LinkAliases: gway end, gwy end, gw end
Permissions: Manage Server

giveaway cancel

Cancel an active giveaway without selecting winners.

~giveaway cancel <message_link>

~giveaway cancel https://discord.com/channels/123/456/789
~gw cancel https://discord.com/channels/123/456/789

Parameters:

message_link — Link to the giveaway message

What It Does:

Cancels the giveaway, no winners selected
Removes reactions
Marks the giveaway message as cancelled
Deletes the giveaway’s stored data

This cannot be undone. Use giveaway end instead if you still want winners selected.

Aliases: gway cancel, gwy cancel, gw cancel
Permissions: Manage Server

giveaway reroll

Select new winners for an ended giveaway, either all winners, a specific count, or specific people.

~giveaway reroll [message_link] [count | @user...]

~giveaway reroll https://discord.com/channels/123/456/789
~gw reroll https://discord.com/channels/123/456/789 1
~gw reroll https://discord.com/channels/123/456/789 @SomeWinner
~gw reroll

Parameters:

message_link — Optional: link to the ended giveaway. If omitted, the most recently ended giveaway in the current channel is used
count — Optional: how many winners to reroll (default: all)
@user — Optional: mention one or more specific winners to replace, instead of rerolling by count

What It Does:

Selects new random winner(s) from the original participant pool
Keeps any winners not being rerolled
Updates the giveaway message
Announces the new winner(s)

Reroll Modes:

reroll <link> — reroll all winners
reroll <link> 1 — reroll only 1 winner, keep the rest
reroll <link> @user — replace that specific winner only
reroll (no link) — targets the last giveaway that ended in this channel

A member being rerolled in must still meet the role/requirement gates that applied when the giveaway ran.

Aliases: gway reroll, gwy reroll, gw reroll
Permissions: Manage Server

giveaway edit

Edit an active (or, for entries, an ended) giveaway’s settings.

~giveaway edit <duration|winner|prize|entries|add-entries|remove-entries|clear-entries> <value> <message_link>

~gw edit duration 2d https://discord.com/channels/123/456/789
~gw edit winner 3 https://discord.com/channels/123/456/789
~gw edit prize New Prize Name https://discord.com/channels/123/456/789
~gw edit entries @VIP:5 @Booster:2 https://discord.com/channels/123/456/789

Edit Options:

duration — Extend or shorten the giveaway. Accepts either a relative duration (2d, 6h) or an absolute date/time. Resets the giveaway to active if it had ended
winner / winners — Change the winner count
prize — Update the prize description
entries — Replace all entry multiplier roles
add-entries — Add or update entry multiplier roles, keeping existing ones
remove-entries — Remove specific entry multiplier roles
clear-entries — Remove all entry multipliers

Entry Management:

# Replace all entry roles
~gw edit entries @VIP:5 @Booster:3 <link>

# Add/update entry roles, keep existing ones
~gw edit add-entries @Supporter:2 <link>

# Remove specific entry roles
~gw edit remove-entries @VIP @Booster <link>

# Clear all entry multipliers
~gw edit clear-entries <link>

Changing entries recalculates every current participant’s entry count against the new roles immediately.

Aliases: gway edit, gwy edit, gw edit
Permissions: Manage Server

giveaway list

View all active giveaways in your server.

~giveaway list

~giveaway list
~gw list

What It Shows:

All ongoing (not yet ended) giveaways
Prize for each, linked to its giveaway message
Time remaining until each ends

Aliases: gway list, gwy list, gw list
Permissions: Manage Server

giveaway blacklist

Block specific users or roles from entering any giveaway in this server.

~giveaway blacklist add <@user|@role|id|username>
~giveaway blacklist remove <@user|@role|id|username>

~gw blacklist add @SomeUser
~gw blacklist add @Muted
~gw blacklist remove @SomeUser

What It Does:

add — Prevents the user or anyone with that role from entering giveaways. If they’ve already entered, they’re blocked from future entries but existing entries aren’t retroactively removed
remove — Lifts the restriction

Accepts a mention, raw ID, or username/nickname lookup.

This is also manageable from the Blacklist button inside giveaway setup.

Aliases: gway blacklist, gwy blacklist, gw blacklist
Permissions: Manage Server

giveaway placeholders

View every placeholder available for a custom giveaway embed or container.

~giveaway placeholders

~gw placeholders

Giveaway Info:

{giveaway.prize} — the prize text
{giveaway.ends} — relative end time (e.g. “in 2 hours”)
{giveaway.ends_full} — full end timestamp
{giveaway.winners} — winner count
{giveaway.winners_list} — mentions of winners, or “Nobody won”
{giveaway.host} — host mention
{giveaway.entries} — entry count

Requirements:

{giveaway.required_role} — required role mention, or “None”
{giveaway.requirements} — comma-separated requirements, or “None”
{giveaway.entry_multipliers} — role: ×N pairs, or “None”

Server / General: All placeholders available to container syntax also work inside a giveaway’s custom embed/container, for example:

{guild.name}, {guild.icon}, {guild.count}, {guild.boost_count}
{channel.mention}
{time}, {timestamp}, {date}, {unix}
{random.color}

These placeholders resolve inside whatever embed or container you’ve set via giveaway setup → Set Custom Embed/Container. If a placeholder can’t resolve to a valid value (for example, an image/thumbnail URL that failed to parse), that piece falls back to plain text instead of breaking the message.

Aliases: gway placeholders, gwy placeholders, gw placeholders
Permissions: Manage Server

How It Works

Run Setup Once

Configure mode, style, and (optionally) requirements/blacklist/custom message:

~gw setup

Start a Giveaway

Create a giveaway with your settings:

~gw start 1d 2 Discord Nitro @Booster:3

Members Enter

Depending on your configured mode:

Reaction mode — members react with 🎉 to enter
Button mode — members click Enter Giveaway

In both modes:

Default: 1 entry per person
Boosters (in the example above): 3 entries each
Role restrictions and requirements (booster/VC/messages/invites) apply if set
Blacklisted users/roles are blocked automatically

Winners Selected

When time expires (or you end it early):

Random winners are selected, weighted by entries
Winners are announced in the channel
The giveaway message updates to show final entries and winners

Reroll if Needed

Pick new winners, all of them, a specific count, or specific people:

~gw reroll <message_link>
~gw reroll <message_link> 1
~gw reroll <message_link> @SomeWinner

Entry System

Basic Entry

Everyone gets 1 entry by default when they enter (react or click, depending on mode).

Role Restrictions

Limit who can enter:

~gw start 1d 1 Prize @Members

Only members with @Members can enter; anyone else attempting to enter is notified and rejected.

Requirement Gates

Configured in giveaway setup → Requirements, independent of role restriction:

Booster — must currently be boosting the server
In VC — must be in a voice channel at the moment of entry
Messages — must have sent a minimum number of tracked messages
Invites — must have a minimum number of tracked invite uses

If a member stops meeting a Booster or VC requirement after entering (they unboost, or leave voice), they’re automatically removed from the giveaway and notified.

Entry Multipliers

Give certain roles more entries:

~gw start 1d 1 Prize @Booster:3 @VIP:5

Regular members: 1 entry
Boosters: 3 entries
VIP: 5 entries

Combined System

Restrict and multiply at the same time:

~gw start 1d 1 Prize @Verified @Booster:2 @VIP:4

Must have @Verified to enter
Boosters with @Verified: 2 entries
VIP with @Verified: 4 entries

Blacklist

Users or roles added via giveaway blacklist add (or the setup panel) can never enter any giveaway in the server, regardless of role restrictions or requirements.

Custom Embeds & Containers

Instead of the default giveaway layout, you can point a server’s giveaways at one of your own saved embeds or containers.

Build and save an embed (embed create ... --name mygiveaway) or container (container create ... --name mygiveaway)
Run giveaway setup → Set Custom Embed/Container and enter its name
Use {giveaway.*} placeholders (see giveaway placeholders) anywhere in that embed/container, alongside the general {guild.*}, {channel.*}, {user.*}, and {time}-style placeholders

In button mode, the Enter Giveaway / Participants buttons are automatically appended to your custom embed or container, you don’t need to add them yourself.

Changing your server’s Style (embed ↔ container) clears any previously set custom message, since an embed and a container aren’t interchangeable formats.

Duration Examples

Common Durations
Specific Times

# 30 minutes
~gw start 30m 1 Prize

# 1 hour
~gw start 1h 1 Prize

# 12 hours
~gw start 12h 1 Prize

# 1 day
~gw start 1d 1 Prize

# 1 week
~gw start 7d 1 Prize

# 90 minutes
~gw start 90m 1 Prize

# 6 hours
~gw start 6h 1 Prize

# 3 days
~gw start 3d 1 Prize

# 2 weeks
~gw start 14d 1 Prize

# 1 month
~gw start 1mo 1 Prize

Permission Requirements

Bot Permissions

The bot needs:

Send Messages
Embed Links
Add Reactions (reaction mode)
Manage Messages (to remove reactions)
Use External Emojis (for the giveaway emoji)

User Permissions

Command Requirements:

Manage Server — all giveaway commands, including setup, blacklist, and placeholders
None — entering a giveaway (react or click the button)

Aliases

All giveaway commands support multiple aliases:

giveaway

Full command

gway

Short form

gwy

Shorter form

gw

Shortest form

Usage Examples

# Basic giveaway
~gw start 1d 1 Discord Nitro

# Multiple winners
~gw start 12h 3 Steam Keys

# Longer duration
~gw start 7d 5 Custom Roles

# Members only
~gw start 1d 1 Prize @Members

# VIP only
~gw start 12h 2 Exclusive Prize @VIP

# Verified users
~gw start 3d 1 Prize @Verified

# Boosters get an advantage
~gw start 1d 1 Nitro @Booster:3

# Multiple tiers
~gw start 2d 2 Prize @VIP:5 @Supporter:2

# Combined with restriction
~gw start 1d 1 Prize @Members @Booster:3 @VIP:5

# View active giveaways
~gw list

# End early
~gw end <message_link>

# Cancel giveaway
~gw cancel <message_link>

# Pick new winners
~gw reroll <message_link>

# Reroll 1 winner
~gw reroll <message_link> 1

# Reroll a specific winner
~gw reroll <message_link> @SomeWinner

# Extend duration
~gw edit duration 2d <link>

# Change winner count
~gw edit winner 5 <link>

# Update prize
~gw edit prize New Amazing Prize <link>

# Add entry roles
~gw edit add-entries @Supporter:2 <link>

# Remove entry role
~gw edit remove-entries @VIP <link>

# First-time setup
~gw setup

# Block a user
~gw blacklist add @SomeUser

# Unblock a user
~gw blacklist remove @SomeUser

# View custom embed/container placeholders
~gw placeholders

Common Use Cases

Reward server boosters

# Give boosters more chances to win
~gw start 1d 1 Premium Role @Booster:5

# Booster-only giveaway
~gw start 12h 2 Nitro @Booster

Encourage boosting by giving advantages in giveaways, or gate it entirely with the Booster requirement in giveaway setup.

Member milestones

# Celebrate 1000 members
~gw start 3d 10 Custom Roles

# Thank active members
~gw start 1d 5 Gift Cards @Active:2

Celebrate community growth with giveaways, optionally requiring a minimum message count via giveaway setup → Requirements.

Event giveaways

# Holiday giveaway
~gw start 7d 3 Holiday Prizes

# Birthday celebration
~gw start 24h 5 Birthday Prizes

Host special event giveaways, and use a themed custom container for the occasion.

Tiered entry system

# Multiple supporter tiers
~gw start 2d 3 Prize @Bronze:2 @Silver:3 @Gold:5 @Platinum:10

# Staff appreciation
~gw start 1d 2 Prize @Helper:2 @Mod:3 @Admin:5

Create fair but tiered entry systems.

Keep giveaways clean

# Block a known giveaway abuser
~gw blacklist add @ProblemUser

# Block an entire muted/timed-out role
~gw blacklist add @Muted

Prevent specific people from entering any future giveaway without having to police each one manually.

Fix mistakes

# Wrong duration
~gw edit duration 3d <link>

# Wrong prize
~gw edit prize Corrected Prize Name <link>

# Change winner count
~gw edit winner 5 <link>

# Invalid winner
~gw reroll <link> 1

Correct errors after starting, without needing to cancel and restart the giveaway.

Important Notes

Winner Selection

Winners are selected randomly, weighted by each participant’s entry count
The same person can’t win multiple times in one giveaway
Winners must still hold the required role (if set) at the time the giveaway ends

Entry Tracking

Participants are tracked in real time as they enter or leave
Members who lose their booster status or leave a required voice channel are automatically removed and notified
Rerolls draw from the original participant list, not new entries
Role changes are respected at the moment winners are selected

Role Management

Create roles to use as giveaway prizes or entry multiplier tiers

Containers

Build custom containers to use as your giveaway’s display message

Getting Started

Premium

Security & Protection

VoiceMaster & Music

Server Management

Role & Member Management

Engagement & Events

Automation & Webhooks

Overview

Setup

Commands

How It Works

Entry System

Basic Entry

Role Restrictions

Requirement Gates

Entry Multipliers

Combined System

Blacklist

Custom Embeds & Containers

Duration Examples

Permission Requirements

Bot Permissions

User Permissions

Aliases

giveaway

gway

gwy

gw

Usage Examples

Common Use Cases

Important Notes

Role Management

Containers

​Overview

​Setup

​Commands

​How It Works

​Entry System

​Basic Entry

​Role Restrictions

​Requirement Gates

​Entry Multipliers

​Combined System

​Blacklist

​Custom Embeds & Containers

​Duration Examples

​Permission Requirements

Bot Permissions

User Permissions

​Aliases

giveaway

gway

gwy

gw

​Usage Examples

​Common Use Cases

​Important Notes

​Related Features

Role Management

Containers

Overview

Setup

Commands

How It Works

Entry System

Basic Entry

Role Restrictions

Requirement Gates

Entry Multipliers

Combined System

Blacklist

Custom Embeds & Containers

Duration Examples

Permission Requirements

Aliases

Usage Examples

Common Use Cases

Important Notes

Related Features