Giveaways

Giveaways let you raffle off anything - Nitro, gift cards, in-game bundles - right inside your server. The bot posts an embed with an Enter Giveaway button, members click to enter, and when the timer runs out the bot draws random winners, announces them in the channel, and DMs each winner.

Tier	Free
Command	/giveaway
Who can use	Everyone can enter, Admins manage
Also on dashboard	Yes

How it works

An admin starts a giveaway with /giveaway create (or from the dashboard). The bot posts the giveaway embed showing the prize, a live countdown, the entry count, and how many winners will be drawn. Anyone can click Enter Giveaway to join - clicking again shows a private message with a Leave Giveaway button in case they change their mind.

When the countdown hits zero, the bot:

1. Picks the winners at random from everyone who entered.
2. Updates the embed to show the winners and disables the button.
3. Posts a congratulations message in the channel.
4. Sends each winner a DM (when their DMs are open).

If fewer people entered than the number of winners, everyone who entered wins. If no one entered, the giveaway ends with no winners.

Fair draws

Winners are picked uniformly at random - one entry per member, no weighting, no rigging. A member can only enter each giveaway once.

Commands

/giveaway create

Start a giveaway. The embed posts immediately and the countdown starts.

Option	Type	Required	Description
prize	text	Yes	What’s being given away (becomes the embed title)
duration	text	Yes	How long it runs: 30m, 12h, 3d, or 1w (1 minute to 4 weeks)
winners	number	No	How many winners to draw, 1 to 20 (default 1)
description	text	No	Extra details shown in the embed - how to claim, eligibility, and so on
channel	channel	No	Channel to post in (defaults to the channel you’re in)
required_role	role	No	Only members with this role can enter

/giveaway create prize:Discord Nitro duration:3d winners:2

/giveaway list

See every giveaway currently running in the server - id, prize, channel, entry count, and when each one ends. Only you see the reply.

/giveaway end

End a running giveaway right away instead of waiting for the timer. Winners are drawn and announced immediately. The giveaway option autocompletes with the running giveaways, so just pick one from the list.

Option	Type	Required	Description
giveaway	giveaway	Yes	The giveaway to end (pick from autocomplete)

/giveaway reroll

Draw new winners for a giveaway that already ended - handy when a winner doesn’t claim. New winners are drawn from the entrants who haven’t won yet, announced in the channel, and DM’d, while the original winners stay on the embed.

Option	Type	Required	Description
giveaway	giveaway	Yes	The ended giveaway to reroll (pick from autocomplete)
winners	number	No	How many new winners to draw, 1 to 10 (default 1)

Admins only

Creating, listing, ending, and rerolling all need Administrator or Manage Server, or the server’s Bot Admin role. Entering is open to everyone (minus a required role, if you set one).

From the dashboard

The Giveaways tab at dashboard.codexhelper.com gives you the same controls in the browser:

• See every running giveaway with live entry counts (the list refreshes itself), plus a giveaway history showing who won each one.
• Fill in a prize, duration, winner count, channel, and optional required role, then hit Post Giveaway - the bot posts the embed within about a minute.
• End a running giveaway or reroll a finished one with a click.

Dashboard actions are picked up by the bot within about a minute; everything you start in Discord shows up on the dashboard too.

Limits and notes

• A server can have up to 10 giveaways open at once.
• Durations run from 1 minute to 4 weeks.
• The bot needs Send Messages and Embed Links in the giveaway channel.
• Winner DMs are best-effort: members with DMs closed still win and are announced, they just don’t get the private message.
• Entries survive bot restarts - the button keeps working and the countdown picks up where it left off.