Miscellaneous

Giveaways

Host engagement-driven giveaways with role requirements and custom prizes.


Note:

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.
Tip:

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 claim works too. ,giveaway claimtime off turns 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 from giveaway 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

  1. 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.

  2. 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.

  3. Confirm the template

    Review the confirmation prompt. If the template produces multiple buttons, the prompt reflects that. Click the button to finalize the template.

  4. Template takes effect immediately

    All new giveaways launched after this point will use your custom template. Existing giveaways keep their original format unless edited.

  5. View or reset the template

    Run ,giveaway template with no code to see the current template. Run ,giveaway template clear or ,giveaway template none to revert to the default.

Template Variables

These variables are available in every giveaway template and substitute their current values when the giveaway renders:

VariableDescriptionSample Value
{prize}The prize descriptionNintendo Switch
{description}The giveaway description (empty if not set)Courtesy of our partners
{winners}Number of winners to select2
{entries}Current number of entries487
{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 endsSeptember 18, 2026 3:45 PM
{ends.timestamp}Unix timestamp of when giveaway ends1726696500
{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 falsefalse

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"

Flags on giveaway start

These flags customize individual giveaways and interact with templates:

FlagValueEffectTemplate Interaction
--role (role)Role mention/name/IDRestricts entry to members with this roleTemplate can reference via {required_role} or conditional {if {required_role}}
--minlevel (level)Number 0-∞Restricts entry to accounts at least this oldTemplate can reference via {min_level}
--maxlevel (level)Number 0-∞Restricts entry to accounts at most this oldTemplate 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 textAdds a description line under the prizeTemplate can reference via {description} or conditional {if {description}}
--image (url)HTTP(S) URLSets the large embed image (ignored in CV2)CV2 templates can use {media} instead
--thumbnail (url)HTTP(S) URLSets 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 emojiAdds emoji to the main button (ignored if template present)Only used if no template is set
--preset (name)Preset nameApplies a saved preset for color, description, image, thumbnail, button, emojiPresets 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, --image are 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 start customize 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.