Skip to main content
You can create a giveaway in two ways. Both end up in the same place, so every limit, permission check and default applies to both.

/gcreate: the quick form

A short form. Best for most giveaways.

/gstart: every option

One command with all options. Best when you know exactly what you want.

/gcreate: the quick form

/gcreate opens a form with:
  1. Prize
  2. Duration (see Durations)
  3. Winners
  4. Prize image (optional upload, up to 8 MB)
  5. What happens next? Choose Publish now to post straight away with your server defaults, or Customize in Studio to fine-tune first.
If something is wrong (for example an invalid duration), you get a private message with an Edit and Try Again button. Everything you typed is kept, and the form stays valid for 15 minutes.

/gstart: every option

All options are optional. If a duration or prize is still missing after your template and defaults are applied, the bot asks for it.

Basics

text
How long the giveaway runs, like 1d or 2h.
number
How many winners.
text
What is being given away.
text
Start from a saved template. Anything you type overrides it.
channel
Where to post. Text, announcement and thread channels work.
user
Who is shown as the host.
text
Extra text shown on the giveaway.
file
Main image.
file
Small image shown beside the text.
text
A custom message sent when the giveaway starts.

Requirements

roles
Roles members need to enter.
roles
Roles that skip the requirements.
roles
Roles that cannot enter.
number
Minimum days in the server.
number
Minimum Discord account age in days.
number
Messages a member must have sent.
number
Minimum level (at least 1).
true / false
Members must display your server’s official tag. The server must have one.
How these combine is explained in Entry requirements.

Rewards and extras

roles
Roles given to the winners.
text
Bonus entries for roles, for example @Booster 3. See Bonus entries.
number (1 to 10)
The most extra entries a member can earn from voting.
true / false
Winners claim with one button, and unclaimed prizes are rerolled automatically.
number
Repeat the giveaway this many times. Tier 1
true / false
Automatically re-send the giveaway. Tier 2
You need Administrator, Manage Server or a Giveaway Manager role. The bot also checks it can see and post in the target channel, and add reactions for reaction giveaways.

Examples

Limits

Duration, winner count and repeat count depend on your Premium tier. If you go over, the bot tells you exactly which limit applies.

Schedule it

Save a template

Manage it