Miscellaneous
Giveaways
Host engagement-driven giveaways with role requirements and custom prizes.
Slash commands for this page
Set this up in Discord with /configure feature:Giveaway defaults.
Use the slash version of each command below. Prefix commands keep working until March 5, 2027. What is changing
,giveaway→/giveaway list,giveaway end→/giveaway end,giveaway reroll→/giveaway reroll,giveaway blacklist→/giveaway blacklist,giveaway setmax→/giveaway setmax,giveaway dmcreator→/giveaway dmcreator
,giveaway dmwinners→/giveaway dmwinners,giveaway start→/giveaway start,giveaway claimtime→/giveaway claimtime,giveaway award→/giveaway award,giveaway template→/giveaway template,giveaway edit prize→/giveaway edit prize,giveaway edit winners→/giveaway edit winners,giveaway edit duration→/giveaway edit duration,giveaway edit description→/giveaway edit description,giveaway preset save→/giveaway preset save,giveaway preset list→/giveaway preset list,giveaway preset delete→/giveaway preset delete
Overview
greed's giveaway system is built for high engagement. It supports buttons for easy entry, role-based requirements, and full customization of the giveaway embed.
Starting a Giveaway
Create a giveaway by specifying the duration, winner count, and the prize.
,giveaway start (duration) (winners) (prize) [--flags]Required arguments:
(duration): How long the giveaway runs (e.g.,1h,30m,2d)(winners): Number of winners to select (1-50)(prize): Description of the prize
Available flags:
--role (role): Restrict entry to members with this role--minlevel (level): Minimum account level to enter--maxlevel (level): Maximum account level to enter--color (hex): Custom embed color (e.g.,#FF5733)--description (text): Additional giveaway details--image (url): Header image URL--thumbnail (url): Thumbnail image URL--button (label): Custom "Enter" button text--emoji (emoji): Custom emoji for the button--preset (name): Use a saved preset--claim (duration): Winners must press Claim prize within this time (1 minute to 7 days) or a new winner is picked. Needs winner DMs turned on.
All flags are optional. The giveaway will use default styling if none are provided.
Giveaway Management
Control your active giveaways with these subcommands.
,giveaway end [message]: Force a giveaway to end immediately.,giveaway reroll [message]: Pick new winners for a finished giveaway.
Modify an active giveaway without restarting it:
,giveaway edit prize (message) (value): Change the prize description.,giveaway edit winners (message) (value): Update the number of winners (1-50).,giveaway edit duration (message) (value): Extend or shorten the remaining time.,giveaway edit description (message) (value): Add or change the description.
,giveaway blacklist (role): Toggle a role's blacklist status (blacklisted members cannot enter).,giveaway setmax (role) (entries): Set the maximum entries allowed for members with a specific role.
,giveaway dmcreator: Toggle whether the giveaway host receives a DM when the giveaway ends.,giveaway dmwinners: Toggle whether winners receive direct messages.
With winner DMs on, you can make winners claim their prize. Each winner gets a Claim prize button in their DM and on the winner announcement, which shows when the claim window closes. If a winner does not press it in time, greed picks a new winner from the remaining entries, and that winner gets their own claim window. Members who already won or let a claim run out are never picked again for the same giveaway.
,giveaway start ... --claim 1h: Set a claim window for one giveaway.,giveaway claimtime (duration): Set the default claim window for every giveaway in the server (1 minute to 7 days).,giveaway claimworks too.,giveaway claimtime offturns it off, and running it with nothing shows the current window.
Turning winner DMs off also turns the default claim window off. You can set the default from /configure under Giveaways too.
An award is something greed delivers privately to each winner, such as a link, a code or instructions. It is never shown in the channel.
,giveaway award [message]: Opens a private form to set or clear the award for a running or ended giveaway. Reply to the giveaway or pass its message ID.
Without a claim window, winners get the award by DM as soon as they win. With one, they get it right after they press Claim prize. If a winner has their DMs closed, greed shows the award to them privately when they claim, and pressing Claim prize again shows it again. Without a claim window, a winner with closed DMs does not receive the award, so use a claim window when that matters. A rerolled winner gets the same award, and someone who already claimed is never picked again by a reroll.
Awards are kept for 30 days after a giveaway ends and all claims are settled, then deleted.
You can also run giveaways by chatting with the assistant in the dashboard. Ask something like "start a 2 day Nitro giveaway in #giveaways for level 10+ members with the Verified role" and it shows you the plan to approve before anything is posted.
The assistant can start, edit, end and reroll giveaways, set entry requirements (a required role, a minimum or maximum level), set a claim window, and change the server-wide settings: host and winner DMs, the default claim window, blacklisted roles and roles that get extra entries. You need Manage Server, and greed needs to be able to post in the channel.
Customization
Presets
Save and reuse giveaway configurations to speed up creation.
,giveaway preset save (name) [--flags]: Save current settings as a preset with all the flags fromgiveaway start.,giveaway preset list: View all saved presets.,giveaway preset delete (name): Remove a saved preset.
Custom Templates
Templates let you fully customize how the giveaway embed appears. Instead of the default format, you define the exact layout using a templating script.
The Template Lifecycle
Write a template script
Use the giveaway variables and template syntax to define your custom embed or Components V2 layout. Test locally to validate the syntax.
Set the template
Run
,giveaway template (code)and paste your template. The bot validates it against a sample giveaway, checking for syntax errors and that at least one button is present.Confirm the template
Review the confirmation prompt. If the template produces multiple buttons, the prompt reflects that. Click the button to finalize the template.
Template takes effect immediately
All new giveaways launched after this point will use your custom template. Existing giveaways keep their original format unless edited.
View or reset the template
Run
,giveaway templatewith no code to see the current template. Run,giveaway template clearor,giveaway template noneto revert to the default.
Template Variables
These variables are available in every giveaway template and substitute their current values when the giveaway renders:
| Variable | Description | Sample Value |
|---|---|---|
{prize} | The prize description | Nintendo Switch |
{description} | The giveaway description (empty if not set) | Courtesy of our partners |
{winners} | Number of winners to select | 2 |
{entries} | Current number of entries | 487 |
{host} | Mention of the giveaway creator | <@123456789012345678> |
{host.id} | User ID of the giveaway creator (no mention) | 123456789012345678 |
{ends} | Time remaining in relative format (e.g. "in 2 hours") | in 2 hours |
{ends.long} | Full date and time when giveaway ends | September 18, 2026 3:45 PM |
{ends.timestamp} | Unix timestamp of when giveaway ends | 1726696500 |
{required_role} | Mention of the required role if set; empty otherwise | <@&987654321098765432> |
{min_level} | Minimum account level required (0 if not set) | 5 |
{max_level} | Maximum account level allowed (0 if not set) | 50 |
{ended} | Whether the giveaway has finished: true or false | false |
Template Syntax
Giveaway templates use greed's script engine. Two modes are available:
Embed Mode (default)
Write a script using embed and button syntax. Variables substitute automatically. Example:
{embed}
{title: {prize} Giveaway}
{description: {entries} entries • {winners} winner{if {winners} != 1}s{/if}}
{button: label: Enter}Components V2 Mode
Start your template with {cv2} to use a richer component system. Example:
{cv2}
{container}
{text: **{prize} Giveaway** | {entries} entries}
{text: Ends {ends}}
{button: label: Enter}
{/container}See Embed Scripting, Components, and Variables for complete syntax documentation.
Worked Examples
A basic template using embed syntax with core variables:
{embed}
{title: 🎉 {prize} Giveaway}
{description: {entries} entries • {winners} winner(s)}
{field: Ends::{ends}}
{field: Hosted by::{host}}
{color: #5d86cf}
{button: label: Enter to Win}Renders as:
- Title: "🎉 Nintendo Switch Giveaway"
- Description: "487 entries • 2 winners"
- Field: "Ends: in 2 hours"
- Field: "Hosted by: @ModName"
- Color: brand blue
- Single button: "Enter to Win"
Uses conditionals to show different content based on state:
{embed}
{title: {prize}}
{description: {entries} participants competing{if {entries} != 1}!{else}.{/if}}
{field: Winners::{winners}}
{if {required_role}}
{field: Requirement::{required_role}}
{/if}
{if {description}}
{field: Details::{description}}
{/if}
{field: Ends::{ends.long}}
{color: #5d86cf}
{button: label: Click to Enter}Behavior:
- The "Requirement" field only appears if you set
--roleon the giveaway. - The "Details" field only appears if you set
--descriptionon the giveaway. - The plural "!" or "." adapts based on entry count.
Advanced layout using containers and sections:
{cv2}
{container: accent_color: #5d86cf}
{text: **🎁 {prize}**}
{separator}
{text: **{entries}** entries • **{winners}** winner{if {winners} == 1}{else}s{/if}}
{if {description}}
{text: *{description}*}
{/if}
{section}
{text: **Ends in:** {ends}}
{text: **Hosted by:** {host}}
{thumbnail: }
{/section}
{actionrow}
{button: label: Enter & label: style: primary}
{/actionrow}
{/container}Features:
- Container with brand color accent
- Section with thumbnail for visual interest
- Conditional text based on description presence
- ActionRow with styled button
Flags on giveaway start
These flags customize individual giveaways and interact with templates:
| Flag | Value | Effect | Template Interaction |
|---|---|---|---|
--role (role) | Role mention/name/ID | Restricts entry to members with this role | Template can reference via {required_role} or conditional {if {required_role}} |
--minlevel (level) | Number 0-∞ | Restricts entry to accounts at least this old | Template can reference via {min_level} |
--maxlevel (level) | Number 0-∞ | Restricts entry to accounts at most this old | Template can reference via {max_level} |
--color (hex) | Hex code (#RGB or #RRGGBB) | Overrides embed color (ignored in CV2) | CV2 templates can define their own accent colors |
--description (text) | Any text | Adds a description line under the prize | Template can reference via {description} or conditional {if {description}} |
--image (url) | HTTP(S) URL | Sets the large embed image (ignored in CV2) | CV2 templates can use {media} instead |
--thumbnail (url) | HTTP(S) URL | Sets the embed thumbnail (ignored in CV2) | CV2 templates can use {section} with {thumbnail} |
--button (label) | Any text (≤80 chars) | Custom label for the main Enter button (ignored if template present) | Only used if no template is set |
--emoji (emoji) | Unicode/custom emoji | Adds emoji to the main button (ignored if template present) | Only used if no template is set |
--preset (name) | Preset name | Applies a saved preset for color, description, image, thumbnail, button, emoji | Presets fill in defaults; direct flags override |
Flags on giveaway preset save
Presets store reusable styling. They support these flags (matching giveaway start):
--color (hex): Embed color--description (text): Description line--image (url): Large image--thumbnail (url): Thumbnail image--button (label): Button label--emoji (emoji): Button emoji
Presets are applied when you run giveaway start --preset (name). Direct flags on start override preset values.
How Presets and Templates Interact
- Template set, no preset: The template controls the entire layout. Flags like
--button,--color,--imageare ignored. - Preset set, no template: The preset provides styling defaults for the built-in embed format. You can override individual values with flags on
start. - Both set: The template takes priority. Preset values are ignored.
- Neither set: The built-in default embed format is used. Flags on
startcustomize it.
Troubleshooting
The script engine requires at least one output. Check that your template:
- Has at least one
{embed}block, or - Starts with
{cv2}and contains at least one{text},{button}, or visible component. - If all content is wrapped in failed conditionals, the output will be empty and the giveaway will fall back to the default format.
Giveaway templates must contain at least one button (for "Enter" and optionally "View Entries"). If your template has no buttons, validation fails. Add a button:
{button: label: Enter}or in CV2:
{button: label: Enter}If you reference a variable that does not exist (e.g., {timeLeft} instead of {ends}), it substitutes as empty string. Check the template variables table above for exact names.
Embeds have hard limits: title ≤256 chars, description ≤4096 chars, total fields ≤25, field name ≤256 chars, field value ≤1024 chars. If your template produces content exceeding these, validation fails. Simplify the template or use Components V2 instead.
Components V2 allows max 5 buttons per row, 5 rows max, and 25 total sections. If exceeded, validation fails. Check the Components page for component limits.
Conditionals use {if condition}, {elseif condition}, {else}, and {/if}. Supported operators: == (case-insensitive equality) and != (case-insensitive inequality). Truthiness: non-empty strings are true; "", "false", "no", "0", "none", and "null" are false. Example:
{if {entries} == 0}
No one has entered yet!
{/if}Changing the template only affects new giveaways. Existing active giveaways keep their original embed unless you edit them (e.g., ,giveaway edit prize (message) (new prize)), which triggers a re-render using the new template.
Technical Details
- Participation: Users enter by clicking the button on the giveaway message.
- Winner Selection: greed uses cryptographically secure randomization for fair winner selection.
- Duration: Giveaways must run between 10 seconds and 30 days.
- Message Reference: Use the message ID or reply to a giveaway message to reference it in edit/end/reroll commands.