Documentación / Giveaways / Comandos / /giveaway create
Admin Server only

/giveaway create

Create a quick giveaway in this channel.

Usage

Generated
/giveaway create <title> <duration> [prize] [winners] [tiers] [drop]
OptionTipoObligatorioDescripción
title text Giveaway title
duration text Duration (e.g. 30m, 2h, 1d)
prize text No Single prize, or leave blank and use 'tiers' for multi-tier
winners whole number No Number of winners (default 1, single-prize only)
tiers text No Multi-tier syntax: "rank:count:prize | rank:count:prize" (e.g. "1:1:RTX 4090|2:2:$50 card")
drop yes or no No Drop mode: the first N members to click Enter win instantly, no draw

Who can run it

Generated
Discord defaultEvery member
Command Access presetServer managers
Always allowedThe server owner and, by default, Administrators
Change itDashboard, Services, Giveaways, Commands

The presets keep it for server managers. Server owners and Administrators can always run it. How Command Access works.

What the bot needs

Generated

Giveaways is granted these permissions by the invite link. A command that finds one missing replies privately with what it could not do and changes nothing.

Add ReactionsView ChannelSend MessagesEmbed LinksRead Message HistoryPin Messages

Comportamiento

Checked against the code 2026-09-21

Starts a giveaway right away in the channel where you run the command. The bot posts the giveaway message there and confirms privately: "✅ Giveaway #12 started. Spectator page: https://..." The number is the giveaway id you pass to the other /giveaway commands.

Before anything is created the bot checks that the Giveaways service is enabled for the server ("The Giveaways service is not enabled here.") and that you hold Manage Server, Administrator, or the giveaway host role ("You need Manage Server or the giveaway host role to do that."). It then checks the server's limits: by default 25 running giveaways at a time and 50 created in any 24 hours. Past either limit you get "⚠️ Too many active giveaways in this server (limit 25). End or cancel one first." or "⚠️ Daily create limit reached (50/24h). Try again later."

duration takes a number with a unit: 45s, 30m, 2h, 1d. Decimals work, so 1.5h is ninety minutes. A bare number means minutes. Anything under 30 seconds, or anything the bot cannot read, is refused with "Invalid duration. Use e.g. 30m, 2h, 1d. Minimum 30 seconds." The giveaway ends that long after the command runs.

For a single prize, fill prize and, if you want more than one winner, winners (1 to 100, default 1). For several prize levels, leave prize blank and fill tiers instead: rank:count:prize, with a | between tiers, for example 1:1:RTX 4090|2:2:$50 card. Rank 1 is the top prize. Ranks run 1 to 20, counts 1 to 100, prize text up to 400 characters, and each rank may appear once ("Duplicate rank 1 in tiers. Each rank must appear once."). When tiers is filled, prize and winners are ignored. With neither filled the bot answers "Either prize or tiers must be provided."

Set drop to yes for a drop. A drop has no draw: the post gets an Enter button, the first members to press it win on the spot, one slot per winner across the tiers in rank order, and the post shows "⚡ Drop: the first 3 to click Enter win instantly." with a progress bar and the winners so far. A drop finishes when the last slot is taken, or at the end time with whoever has claimed by then. A member who clicks after the slots are gone is told "All slots are taken. You are entered for a reroll if a winner does not claim."

Without drop, entry is by reaction: the bot adds 🎉 to its post and the post says "React with 🎉 to enter." Removing the reaction withdraws the entry. The post shows the prizes, a Winners count, the end time, the host, a running entry count, and a "Watch live" link to the public spectator page. When the time is up the winners are drawn automatically, the post is replaced by a results message that pings them, and each winner gets a DM.

Good to know

  • The command always uses reaction entry with 🎉, or a drop. The server's default entry method and emoji only apply to giveaways made on the dashboard.
  • A giveaway made this way has no description, entry requirements, weighted entries, or recent-winner window of its own. The server-wide Winner cooldown from the Setup page still applies. Rerolls are allowed and the public page is on.
  • For those options, and for a scheduled start, button entry, tasks, referral entries, or winner confirmation, create the giveaway from the dashboard's New Giveaway page instead.
  • "Giveaway created but failed to post the message. Check bot permissions." means the bot could not post in that channel. Check that it can view the channel, send messages and embeds, and add reactions there.
  • Related: /giveaway end, /giveaway reroll, /giveaway cancel, /giveaway info.
YourBot docs Reference tables are generated from the code that is running. Ask in Discord Suggest a correction