A giveaway is an embed with a Join button. Cloudy tracks entries, draws winners at the end time and
announces them. You can start one from the dashboard or with /giveaway start in Discord.
| License | Premium |
| Tabs | Settings · Giveaways |
| Needs | Send Messages, Embed Links |
Applied whenever a giveaway is started without specifying the value — from Discord or the dashboard.
Optional
Where giveaways are posted when no channel is given. /giveaway start without a channel refuses to
run until either this or the channel option is set; the dashboard form is pre-filled with it.
1–50 · default 1
Default number of winners for new giveaways.
Optional
Pinged when a giveaway is posted. Make it an opt-in role members can pick themselves via
reaction roles — pinging @everyone for every giveaway is how you
lose members.
Optional
Accent colour of the giveaway embed, set in the embed builder below the field. Empty inherits the server embed colour.
The same builder designs the shell of every giveaway card — colour, author line, footer, thumbnail and image. Title, description and the fields are filled in per giveaway and cannot be edited here.
From the dashboard, the Giveaways tab has a Start giveaway form with these fields. In Discord,
/giveaway start takes the same values, with the same limits, as options (see
Commands).
1–256 characters · required
Shown at the top of the embed. Be specific: Nitro Classic — 1 month beats Giveaway.
Up to 2000 characters · optional
Details shown in the embed: what exactly is being given away, how the winner is contacted, any rules you want stated up front.
Required
Channel to post this giveaway in.
1–50 · default from the settings
How many winners to draw. Cloudy draws distinct winners — the same member cannot win twice in one draw.
Required · must be in the future
When the giveaway closes and winners are drawn. Cloudy handles the countdown; you do not need to be online.
Up to 10 roles · optional
Members need at least one of these roles to enter. Empty means everyone may enter.
Use it for "subscribers only" or "level 10+" giveaways — paired with a role from level rewards, this is how you gate on activity.
Up to 10 roles · optional
Members holding any of these roles cannot enter. Typically your staff roles.
The Giveaways tab lists active giveaways with their live entry count and end time, and the finished ones with their winner count. A giveaway started from the dashboard shows a Posting… badge until the bot has posted it.
From the dashboard you can cancel a running giveaway: no winner is drawn, and within about
30 seconds the bot turns the posted message into a closed giveaway — the Join button disappears and
the embed says no winners were drawn. Nothing is announced. To end a giveaway with a draw and an
announcement, use /giveaway end in Discord instead.
A posted giveaway cannot be edited, neither from the dashboard nor in Discord. To change one, cancel it and start a new one.
All subcommands require Manage Server by default.
| Command | Does |
|---|---|
/giveaway start | Start a new giveaway. title (up to 256 characters) and duration (30m, 2h, 1d — at least 1 minute, at most 365 days) are required; channel (a text or announcement channel), winners (1–50), description (up to 2000 characters), required_roles and excluded_roles (up to 10 each, comma-separated role IDs or pasted role mentions; roles that do not exist on the server are refused) are optional and fall back to the defaults |
/giveaway end | End it now and draw the winners |
/giveaway close | Cancel it — no winner is drawn. Takes an optional reason |
/giveaway reroll | Draw a fresh set of winners for a giveaway that ended with a draw — from members who have not won it yet |
/giveaway end and /giveaway close are different on purpose: end draws winners immediately,
close cancels the giveaway without a draw. Both pick the giveaway from an autocomplete list of
running ones; reroll lists the ones that ended with a draw — a closed or cancelled giveaway can
never be drawn after the fact.