Giveaway Commands
The explanation for the giveaway commands of Invite Tracker. You can also manage giveaways on the Giveaways dashboard page.
A tutorial video on how giveaways work and how to set them up.
INFO
By default, the giveaway commands can only be used by members with the Administrator permission. You can change who can use them in your server's settings, under Integrations.
Commands
TIP
You can also create giveaways inside a thread with the /giveaway create command!
| Command | Description |
|---|---|
/giveaway create <prize> <duration> <winners> <channel> | Creates a giveaway using the specified information. See below on how to format the duration. |
/giveaway delete <message_id> | Deletes the specified running giveaway |
/giveaway end <message_id> | Ends the specified running giveaway and draws its winners right away |
/giveaway list | Lists all of the server's running giveaways and their message IDs |
/giveaway reroll <message_id> | Chooses new winners for the specified ended giveaway |
/giveaway scheduled | Lists all of the server's scheduled giveaways. Member-goal giveaways show their goal and the server's current member count |
/giveaway templates | Lists all of the server's giveaway templates |
INFO
The duration is a number followed by a time unit. For example 5d = 5 days, 3w2h30m = 3 weeks, 2 hours, and 30 minutes. The supported units are s = seconds, m = minutes, h = hours, d = days, and w = weeks.
Without Premium, a giveaway can last up to 31 days and have up to 20 winners. With Premium, it can last up to 3 months and have up to 100 winners. The prize can be up to 190 characters long.
INFO
When ending a giveaway, Invite Tracker will choose winners, even if the giveaway's minimum of entrants isn't reached.
When deleting a giveaway, Invite Tracker permanently removes it and its message without choosing any winners.
TIP
After creating a giveaway with /giveaway create, click Save as Template under Invite Tracker's reply to save the giveaway as a template and reuse it later.
Optional Arguments
/giveaway create
| Argument | Description |
|---|---|
[image: <file>] | Premium feature. An image shown in the giveaway message. PNG, JPEG or WebP, up to 2MB |
[messages_required: <number>] | Requires members to have sent at least the specified number of messages in order to be able to join the giveaway |
[min_entries: <number>] | Premium feature. The number of entrants the giveaway needs to end with winners |
[min_entries_action: <cancel|extend once>] | What happens when the minimum of entrants isn't reached: cancel the giveaway without winners (default), or extend it once |
[min_entries_extension: <duration>] | How long the giveaway is extended by when min_entries_action is extend once, for example 1d 12h. Between 1 minute and 31 days |
[roles_bonus_entries: <@role> <number>] | Gives bonus entries to members with the specified roles |
[roles_required: <@role>] | The roles required to enter the giveaway |
[roles_required_config: <all|one of>] | Whether members need all of the roles in roles_required (default) or only one of them |
[winner_tiers: <entrants>:<winners>] | Premium feature. More winners as more members enter, for example 50:3 100:5 |
[winners_roles: <@role>] | Premium feature. Roles automatically given to the winners of the giveaway |
INFO
For winners_roles and roles_required, mention multiple roles in the same option value, for example @role1 @role2 @role3. You can add up to 10 roles to each. For roles_bonus_entries, use role-entry pairs in the same option value, for example @role1 10 @role2 20. A role can give up to 1000 bonus entries, and you can add up to 10 roles (30 with Premium). For winner_tiers, use entrants-winners pairs in the same option value, for example 50:3 100:5 draws 3 winners once at least 50 members have entered and 5 once at least 100 have. You can add up to 3 tiers.
INFO
Winner tiers and the minimum of entrants count eligible entrants: members who still meet the requirements and are still in the server when the giveaway ends. Learn more on the Giveaways dashboard page.
/giveaway reroll
| Argument | Description |
|---|---|
[winner_amount: <number>] | Chooses the specified number of new winners when rerolling the giveaway (up to 20, or 100 with Premium). Without it, as many winners as the giveaway ended with are drawn |
