Giveaways
Every /giveaway command and its options.
All /giveaway commands need Administrator. See Giveaways for the limits.
Start and manage#
| Command | What it does |
|---|---|
/giveaway start <duration> <winners> <prize> [options] | Starts a giveaway (options below). |
/giveaway end <giveaway> | Ends a running giveaway now (message ID). |
/giveaway delete <giveaway> | Deletes a giveaway; nobody is drawn. |
/giveaway reroll <giveaway> [winners] | Draws new winners for an ended giveaway. |
/giveaway list [ended] | Lists running giveaways, or ended ones. |
Options of /giveaway start#
| Option | Value |
|---|---|
duration | 10 seconds to 31 days (free) or 93 days (premium), e.g. 1w 2d 6h. |
winners | 1 to 20 (free) or 100 (premium). |
prize | Up to 190 characters. |
description | Up to 1,000 characters. |
channel | Text channel or thread (current one by default). |
roles_required | Role mentions separated by spaces (10 at most). |
roles_required_mode | any (default) or all. |
roles_number_required | 1 to 999 roles among the required ones. |
role_bonus_entries | @role 10 @other 20 (5 roles, 1–1,000 entries each). |
messages_needed | 1 to 1,000,000 messages. |
roles_blacklist | Role mentions (5 at most). |
winners_roles | Roles given to the winners (Premium, 5 at most). |
joined_age_required, account_age_required | Durations up to 25 years, e.g. 1M 2w. |
type | button (default) or reaction. |
save_as_template | Also saves the settings as a template with this name. |
Templates#
| Command | What it does | Plan |
|---|---|---|
/giveaway template create <name> <duration> <winners> <prize> [options] | Saves settings as a template (same options as start, without channel). | 1 free / unlimited premium |
/giveaway template start <name> [channel] | Starts a giveaway from a template. | Free |
/giveaway template list | Lists the templates. | Free |
/giveaway template delete <name> | Deletes a template. | Free |
Planned giveaways#
| Command | What it does | Plan |
|---|---|---|
/giveaway scheduled create <starts_in> <repeat> <duration> <winners> <prize> [options] | Plans a giveaway. starts_in: 1 minute to 366 days; repeat: once, daily, weekly, monthly. | 1 free / unlimited premium |
/giveaway scheduled from-template <template> <starts_in> [repeat] [channel] | Plans a giveaway from a template. | Same |
/giveaway scheduled list | Lists the planned giveaways. | Free |
/giveaway scheduled delete <id> | Cancels a planned giveaway. | Free |