LiveThe dashboard is here. Six years in the making.

Giveaways

Creating a Giveaway

Start a giveaway from the dashboard or with the /giveaway start setup preview.

You can launch a giveaway two ways, and both give you the full set of options: the dashboard has the create form and the live entrant view, and /giveaway start opens an interactive setup preview right in Discord, so staff who never touch the dashboard get every option too. (The New giveaway button in /giveaway manage opens the same preview.)

With the slash command#

/giveaway start <prize> [winners] [duration] [channel] [required-role] [blacklist-role] [host] [starts-in]

Only the prize is required. Everything else falls back to your server's saved defaults or the standard ones (1 winner, 24 hours, your active channel), and you can change all of it in the preview before anything posts.

Running the command shows a private preview of the exact giveaway message, with buttons to adjust everything:

  • Edit details: prize, winners, duration, and the scheduled start (Premium).
  • Requirements: pick one or many required roles and blocked roles with a role picker, choose whether members need every role or any one of them, toggle winner DMs, set bonus entries, bypass roles, and age minimums (Premium). See Requirements and Entries.
  • Appearance: the entry button's label and emoji, the embed title, message, and color, an image (Large or Small), and the button color (Premium).
  • Premium extras: show someone else as the host, give winners a role automatically, and set a winner claim window.

When it looks right, press Post giveaway. Nothing posts until you do, so you can never launch a half-configured giveaway by accident.

OptionNotes
prizeWhat you're giving away. Shown in the giveaway message.
winnersHow many members win. Default 1.
durationHow long it runs, like 1h, 2d, or 1w. Default 24 hours.
channelWhere it posts. Defaults to your active channel (set with /channel).
required-roleAdds a required role. Pick more in the preview's role picker.
blacklist-roleAdds a blocked role. Pick more in the preview's role picker.
hostShow this member as "Hosted by" instead of you (Premium).
starts-inSchedule the start for later, like 1h or 2d (Premium).

From the dashboard#

Open Configuration → Giveaways and fill in the create form:

OptionNotes
PrizeWhat you're giving away. Shown in the giveaway message.
WinnersHow many members win. Up to 10 free, 50 with Premium.
DurationHow long it runs, like 1d, 12h, 1w.
ChannelWhere it posts. Defaults to your selected channel.
RequirementsRequired / blacklist roles, and the Premium options. See Requirements and Entries.
Custom embedStyle the giveaway message to match your server.
Embed imageA direct https image link shown on the giveaway. Pick Large for a full-width image or Small for a corner thumbnail.
Button label / emojiOverride the default 🎉 Enter button.
Giveaway hostShow a member of your choice as "Hosted by" instead of you, for giveaways you run on someone's behalf (Premium).
Winner claim windowHours winners have to press Claim before their slot is rerolled. See claim windows (Premium).
Schedule startPost the giveaway later, at a set time (Premium).

Press create and Zira posts the giveaway (or holds it until its scheduled start).

One thing is set in stone: the prize cannot be changed after a giveaway is created. Everything else can be edited while it runs, but the prize people entered for stays the prize, so nobody can be baited into entering for one thing and drawn for another. If you named the wrong prize, cancel the giveaway and start a new one.

Saved server defaults#

Premium

Press Save as server defaults in the setup preview, or on the dashboard's create form, and Zira remembers your current setup: winners, duration, channel, requirements, button style, image, winner role, and claim window. Every future /giveaway start and every fresh dashboard create form starts from those settings, so regular giveaways become "type the prize, press Post". Saving defaults is a Premium feature.

Winner claim windows#

Premium

Set a claim window (1 to 168 hours) and winners must press a Claim prize button on the winner announcement within that time. If a winner does not claim in time, Zira automatically rerolls their slot to a new winner, who gets their own claim window. No more prizes sitting unclaimed with a ghost. Winners are told about the deadline in the announcement and in their winner DM. A Premium feature.

Scheduled start#

A scheduled giveaway is created now but posts at the time you set, then runs for its duration from that point. You can schedule from the dashboard's Schedule start field or with the slash command's starts-in option.

Premium

Scheduling a giveaway to start later is a Premium feature.

Duration limits#

Premium

Free servers can run a giveaway for up to 30 days. With Premium, up to 365 days.

Permissions Zira needs#

  • Send Messages and Embed Links in the giveaway channel.
  • Read Message History so Zira can edit the giveaway message to show the winners and the live count.

If Zira cannot post in the channel you picked, the preview tells you and nothing is created; pick another channel and press Post again.