Giveaways
Run, manage, and configure giveaways with templates and role restrictions.
Card Companion's giveaway system lets you run, manage, and configure giveaways directly in Discord. All giveaway commands are under /giveaway.
Permissions required: Manage Server, or a configured creator role.
Starting a Giveaway#
The minimum required options are prize and duration:
Duration accepts s, m, h, and d — e.g. 30m, 2h, 1d. Maximum is 30 days.
Full Options#
| Option | Description |
|---|---|
| prize | What the giveaway is for (required) |
| duration | How long the giveaway runs (required) |
| winners | Number of winners, default 1 (max 20) |
| donor | Optional user to credit as the donor |
| requirements | Role(s) required to enter — mention or ID, comma-separated |
| bypass | Role(s) that can enter regardless of requirements |
| blacklist | Role(s) that cannot enter |
| multipliers | Entry multipliers e.g. @Role:2 for double entries |
| messages_required | Minimum messages a user must send to qualify |
| message_channel | Restrict message counting to a specific channel |
| message_cooldown | Cooldown in seconds between counted messages |
| drops_required | Minimum Karuta drops since the giveaway started |
| image | Attachment to display in the embed |
| template | Apply a saved template's defaults |
Example with Restrictions#
/giveaway start prize:Custom frame duration:12h winners:3 requirements:@Member bypass:@ModeratorManaging Active Giveaways#
Edit a running giveaway (prize, winner count, or add time):
/giveaway edit message_id:1234567890 prize:Updated prize extend:2hDelete a giveaway early without picking winners:
/giveaway delete message_id:1234567890Reroll winners after a giveaway ends:
/giveaway reroll message_id:1234567890The message_id is the ID of the giveaway embed message. Right-click the message in Discord and choose Copy Message ID (Developer Mode must be on).
Templates#
Templates save a set of defaults so you don't have to retype the same options every time.
Create a template:
/giveaway template create name:Standard winners:1 requirements:@MemberList all templates:
/giveaway template listUse a template when starting:
/giveaway start prize:Card drop duration:1h template:StandardOptions passed directly to /giveaway start override the template's defaults for that giveaway.
Delete a template:
/giveaway template delete name:StandardTemplate End Message#
Templates support a custom end announcement with tokens:
/giveaway template create name:Fancy end_message:🎉 {winners} won {prize}! Thanks {hoster}!Available tokens: {winners}, {prize}, {count}, {hoster}, {donor}
Giveaway Settings#
Open the interactive settings menu to configure DM notifications, creator roles, and a log channel:
/giveaway config| Setting | Description |
|---|---|
| DM host | Send the host a DM when the giveaway ends |
| DM winners | Send each winner a DM with the prize |
| Creator roles | Roles allowed to start/edit giveaways without Manage Server |
| Log channel | Channel where giveaway events (start, end, reroll) are logged |
| Default template | Template applied automatically if none is specified at start |
These settings can also be managed from the web dashboard under Giveaways → Settings.
Last updated June 12, 2026