Managing Giveaways

Once a giveaway is live you can watch it, draw early, reroll, or cancel it. Everything lives in one place: /giveaway manage in Discord, or the dashboard.

The management panel: /giveaway manage#

The easiest way to run giveaways from Discord is the management panel:

/giveaway manage

Only you see it. The panel lists your live giveaways and the most recently ended ones. Pick any of them from the dropdown (or pass an id, which autocompletes by prize name, to open one directly) and every action is a button:

• End & draw winners on a running giveaway, or Cancel a running or scheduled one. Both ask for one confirming click first, so a stray tap never draws or kills a giveaway.
• Reroll winners on an ended giveaway: leave the box empty to reroll them all, or enter a number to draw that many fresh winners.
• Replace a winner picks one specific winner and redraws just their slot.
• Entrants shows the entry count, winners, and newest entrants.
• Edit reopens the live setup preview to change anything about a running or scheduled giveaway, except the prize, which is locked once a giveaway exists so entrants can never be baited and switched. Changing the channel moves the giveaway: Zira reposts the message in the new channel and everyone's entries carry over.
• New giveaway asks for a prize and opens the same setup preview /giveaway start uses, prefilled with your saved server defaults.
• Jump to message and Open on the Dashboard take you straight to the giveaway or the full dashboard page.

That makes the whole /giveaway command just two subcommands: /giveaway start to launch one quickly with options, and /giveaway manage for everything after. (The old end, reroll, cancel, list, entrants, and edit subcommands merged into the panel, which does everything they did.)

Who can manage giveaways#

By default, giveaways need the Manage Server permission (or your command role). To let someone run giveaways without giving them everything else, set a giveaway manager role:

/config giveaway-manager set <Role>

Members of that role can use every /giveaway command and sign in to the dashboard, where they see just the Giveaways page. They can create, edit, draw, reroll, and cancel giveaways, and view History, but they cannot delete History entries or change the settings in the Giveaway settings card (including the manager role itself). You can also pick the role on the dashboard in Configuration → Giveaways → Giveaway settings. Since giveaways can hand out roles, treat it like a moderator permission.

Slash commands#

Command	What it does
/giveaway start	Launch a giveaway: opens the setup preview, with options to prefill it. See Creating Giveaways.
/giveaway manage [id]	The management panel above: end, cancel, reroll, replace a winner, entrants, edit, and new giveaways, all from buttons. The id autocompletes by prize name.

From the dashboard#

Configuration → Giveaways lists your running and scheduled giveaways with a live entry count. For each one you can:

• Edit: change anything about a running or scheduled giveaway except the prize (locked, see above). Winners, duration (leaving it alone keeps the current end time), requirements, button style, image, and the Premium options are all editable, and picking a different channel reposts the giveaway there with all entries intact.
• View entrants: a paginated list of everyone who entered, shown by username (with the user ID a hover away), fast even at thousands.
• End now: draw immediately instead of waiting for the timer.
• Cancel: stop the giveaway without drawing.

History#

Every finished or cancelled giveaway moves into the History section on the same page, so you can always look back at what ran, who entered, and who won:

• Search and filter: by prize text, by ended vs cancelled, by a winner's user ID, or by date range.
• Details: expand any entry to see its requirements, the full entrant list, and the winners by username. Giveaways that ran a claim window also show each winner's claim outcome (claimed, still pending, replaced, or forfeited) and a summary of the window.
• Reroll: redraw winners on a finished giveaway straight from History, excluding anyone who already won.
• Clone: run the same giveaway again with one click (Premium).
• Export: download the entrants and winners as CSV or JSON (Premium).
• Delete: remove a giveaway and its entries from History permanently. You will be asked to confirm; this cannot be undone.

A usage bar at the bottom shows how full your History is. Free servers keep their latest 100 giveaways; older ones are removed as new ones finish. Premium servers keep every giveaway forever.

Giveaway logging (Premium)#

Pick a log channel in the Giveaway settings card on Configuration → Giveaways and Zira posts a message there for every giveaway event in your server: a giveaway starting or going live (a scheduled giveaway logs when it goes live), winners being drawn, a reroll, and a cancellation. It does not matter where the action came from: the dashboard, /giveaway, or a timer all log the same way.

If Zira loses access to the channel, logging switches itself off. Fix the permissions and pick the channel again to turn it back on.

How the draw works#

At the end (timed or manual), Zira:

1. Pulls the entrants and re-validates each against the current requirements, skipping anyone who left or no longer qualifies.
2. Draws the configured number of distinct winners, weighted by any bonus entries.
3. Edits the giveaway message to show the winners and replies with a ping.
4. DMs the winners (unless you turned DMs off).

If there aren't enough valid entrants, Zira draws as many winners as it can and says so.

Rerolling#

A reroll always excludes previous winners, so you won't redraw the same person. From /giveaway manage or the dashboard you can reroll the whole set, redraw a chosen number of winners, or replace one specific winner.

Winner claim windows (Premium)#

If the giveaway was created with a claim window, each winner gets a Claim prize button on the winner announcement and a deadline in their winner DM. A winner who does not claim in time is automatically replaced: Zira rerolls their slot to a new winner, who gets their own claim window. Replaced winners cannot be re-drawn for the same giveaway. If your staff reroll a winner by hand, that overrides the claim automation for the replaced slot.

Zira stops rerolling a slot when the entry pool runs out of eligible members, or after a sensible number of replacements, so a claim chain always ends.