Giveaways

All giveaway commands — create, manage, and customize giveaways on your server.

All giveaway commands require Administrator permission.

Limits: 5 active giveaways (free) / 50 active giveaways (premium).


Start a Giveaway

/giveaway start <duration> <winners> <prize> [options...]

Required Parameters

Parameter
Type
Description

duration

Time string

Duration of the giveaway (min: 10s, max: 31 days)

winners

1–100

Number of winners to pick

prize

Text (max 200 chars)

Prize description

Optional Parameters

Parameter
Type
Description

description

Text (max 1500 chars)

Giveaway description shown in the embed

channel

Text channel

Channel to post the giveaway (default: current channel)

roles_required

Up to 5 roles

Roles required to enter the giveaway

roles_number_required

1–999

How many of the required roles a user must have

roles_blacklist

Up to 5 roles

Roles that cannot enter the giveaway

role_bonus_entries

@role amount pairs

Bonus entries for specific roles (max 5 roles, 1–1000 entries)

messages_needed

1–1,000,000

Minimum messages required to enter

joined_age_required

Time string

Minimum time the user must have been in the server

account_age_required

Time string

Minimum Discord account age

winners_roles

Up to 5 roles

Roles given to winners when the giveaway ends

🌟 type

button or reaction

Entry method (default: button). reaction is Premium only

Time Format

Use a combination of the following: 1Y 1M 2w 1d 6h 1m 10s

Unit
Meaning

Y

Years

M

Months

w

Weeks

d

Days

h

Hours

m

Minutes

s

Seconds

Example: /giveaway start 1d 12h 3 Nitro — starts a 1 day 12 hours giveaway with 3 winners.


Manage Giveaways

Command
Description

/giveaway end <giveaway>

End a running giveaway early and pick winners

/giveaway reroll <giveaway> [winners]

Reroll an ended giveaway with new winners

/giveaway delete <giveaway>

Delete a giveaway entirely

/giveaway list [ended]

List all giveaways. Set ended: True to see past ones

circle-info

The giveaway parameter is the Message ID of the giveaway message. Right-click the giveaway embed → Copy Message ID to get it.


Examples

Simple giveaway:

Giveaway with requirements:

Giveaway with bonus entries:

Last updated