,giveaway

Run a giveaway: create, end, cancel, pause/resume, reroll, list, entries, panel

User permissions: Manage Messages
Cooldown: none
Other surface: /giveaway · 19 slash subs vs 9 prefix
Anchor: #giveaway

Forms

create <duration> <winners> <prize…> [++channel <channel>] [++desc <text>] [++reaction]end [giveaway]cancel [giveaway]pause [giveaway], alias resume/unpausereroll [giveaway]listentries [giveaway]panel [giveaway]

edit <field> <value…> [++target <link|id>]: field is host/prize/duration/winners/description/thumbnail/image/requiredroles/minlevel/maxlevel

Syntax

,giveaway create <duration> <winners> <prize…> [++channel <channel>] [++desc <word>] [++reaction] [++count]

/giveaway <subcommand>

<required> · [optional]

Example

,giveaway create 1h 1 Nitro Classic ++channel #giveaways ++reaction

Subcommands

9 prefix subcommands

Read from the prefix .sub/ tree, the canonical shape. Every entry has a permanent anchor of its own.

,giveaway cancel

Cancel a giveaway: no winner is drawn

,giveaway cancel [giveaway]

,giveaway cancel

#giveaway-cancel

,giveaway createaka start, new

Start a giveaway

,giveaway create <duration> <winners> <prize…> [++channel <channel>] [++desc <word>] [++reaction] [++count]

,giveaway create 1h 1 Nitro Classic ++channel #giveaways ++reaction

#giveaway-create

,giveaway edit

Edit a field on a live giveaway, or open the edit panel with no field

,giveaway edit <field> <value…> [++target <link|id>]  |  giveaway edit [target]

,giveaway edit prize Nitro Boost ++target 123456789012345678

#giveaway-edit

,giveaway endaka draw

Draw a giveaway's winner(s) now

,giveaway end [giveaway]

,giveaway end

#giveaway-end

,giveaway entriesaka participants

See how many people entered a giveaway, and a sample

,giveaway entries [giveaway]

,giveaway entries

#giveaway-entries

,giveaway list

List this server's giveaways

,giveaway list

,giveaway list

#giveaway-list

,giveaway panelaka manage

Open the private host controls for a giveaway, or the hub with none

,giveaway panel [giveaway]

,giveaway panel

#giveaway-panel

,giveaway pauseaka resume, unpause

Pause or resume a giveaway's countdown

,giveaway pause [giveaway] (or `,giveaway resume [giveaway]`)

,giveaway resume

#giveaway-pause

,giveaway reroll

Pick new winner(s) for an ended giveaway

,giveaway reroll [giveaway]

,giveaway reroll

#giveaway-reroll

Slash leaves

19 leaves

Read from the registered slash builder: groups are flattened, so a grouped leaf reads “group leaf” and anchors with a hyphen between the two words.

Two trees, not one view of one

This command registers 19 leaves on the slash surface against 9 subcommands in its prefix tree. Both lists are on this page in full; neither is a summary of the other.

/giveaway create

Start a giveaway (opens a form)

/giveaway createchannelmodecount

Parameter	Type	Default	Detail
`channel`	Channel	here	Channel to post in(text, announcement channels)
`mode`	String	a button	How people enterbutton · reaction (🎉)
`count`	Boolean	the server setting	Show a live entry count on the message

#giveaway-create

/giveaway end

Draw a giveaway now

/giveaway endgiveaway

Parameter	Type	Default	Detail
`giveaway`	String	the most recent running one here	Which giveawayautocompletes as you type: no fixed list

#giveaway-end

/giveaway cancel

Cancel a giveaway: no winner is drawn

/giveaway cancelgiveaway

Parameter	Type	Default	Detail
`giveaway`	String	the most recent running one here	Which giveawayautocompletes as you type: no fixed list

#giveaway-cancel

/giveaway pause

Pause or resume a giveaway's countdown

/giveaway pausestategiveaway

Parameter	Type	Default	Detail
`state`	String	—	Defaults to pausepause · resume
`giveaway`	String	the most recent one here	Which giveawayautocompletes as you type: no fixed list

#giveaway-pause

/giveaway reroll

Pick a new winner from an ended giveaway

/giveaway rerollgiveaway

Parameter	Type	Default	Detail
`giveaway`	String	the most recent ended one here	Which giveawayautocompletes as you type: no fixed list

#giveaway-reroll

/giveaway list

List this server's giveaways

#giveaway-list

/giveaway entries

See how many people entered, and a sample

/giveaway entriesgiveaway

Parameter	Type	Default	Detail
`giveaway`	String	the most recent running one here	Which giveawayautocompletes as you type: no fixed list

#giveaway-entries

/giveaway panel

Open the private host controls for a giveaway

/giveaway panelgiveaway

Parameter	Type	Default	Detail
`giveaway`	String	the most recent one here	Which giveawayautocompletes as you type: no fixed list

#giveaway-panel

/giveaway edit hostgroup edit

Change the host

/giveaway edit hostuser*giveaway

Parameter	Type	Default	Detail
`user`required	User	—	New host
`giveaway`	String	the most recent one here	Which giveaway to editautocompletes as you type: no fixed list

#giveaway-edit-host

/giveaway edit prizegroup edit

Change the prize

/giveaway edit prizevalue*giveaway

Parameter	Type	Default	Detail
`value`required	String	—	New prize(up to 200 characters)
`giveaway`	String	the most recent one here	Which giveaway to editautocompletes as you type: no fixed list

#giveaway-edit-prize

/giveaway edit durationgroup edit

Restart the countdown from now

/giveaway edit durationvalue*giveaway

Parameter	Type	Default	Detail
`value`required	String	—	1h, 30m, 2d
`giveaway`	String	the most recent one here	Which giveaway to editautocompletes as you type: no fixed list

#giveaway-edit-duration

/giveaway edit winnersgroup edit

Change the winner count

/giveaway edit winnersvalue*giveaway

Parameter	Type	Default	Detail
`value`required	Integer	—	New winner count(min 1)
`giveaway`	String	the most recent one here	Which giveaway to editautocompletes as you type: no fixed list

#giveaway-edit-winners

/giveaway edit descriptiongroup edit

Change the description (opens a form)

/giveaway edit descriptiongiveaway

Parameter	Type	Default	Detail
`giveaway`	String	the most recent one here	Which giveaway to editautocompletes as you type: no fixed list

#giveaway-edit-description

/giveaway edit thumbnailgroup edit

Change the thumbnail image

/giveaway edit thumbnailvalueattachmentgiveaway

Parameter	Type	Default	Detail
`value`	String	—	Image URL: blank or "none" clears it
`attachment`	Attachment	—	Or upload an image
`giveaway`	String	the most recent one here	Which giveaway to editautocompletes as you type: no fixed list

#giveaway-edit-thumbnail

/giveaway edit imagegroup edit

Change the large image

/giveaway edit imagevalueattachmentgiveaway

Parameter	Type	Default	Detail
`value`	String	—	Image URL: blank or "none" clears it
`attachment`	Attachment	—	Or upload an image
`giveaway`	String	the most recent one here	Which giveaway to editautocompletes as you type: no fixed list

#giveaway-edit-image

/giveaway edit requiredrolesgroup edit

Change the roles required to enter

/giveaway edit requiredrolesvaluegiveaway

Parameter	Type	Default	Detail
`value`	String	—	Role mentions/IDs, space/comma separated: blank clears
`giveaway`	String	the most recent one here	Which giveaway to editautocompletes as you type: no fixed list

#giveaway-edit-requiredroles

/giveaway edit minlevelgroup edit

Change the minimum level to enter

/giveaway edit minlevelvaluegiveaway

Parameter	Type	Default	Detail
`value`	Integer	—	0 clears it(0–1000)
`giveaway`	String	the most recent one here	Which giveaway to editautocompletes as you type: no fixed list

#giveaway-edit-minlevel

/giveaway edit maxlevelgroup edit

Change the maximum level to enter

/giveaway edit maxlevelvaluegiveaway

Parameter	Type	Default	Detail
`value`	Integer	—	0 clears it(0–1000)
`giveaway`	String	the most recent one here	Which giveaway to editautocompletes as you type: no fixed list

#giveaway-edit-maxlevel

/giveaway edit panelgroup edit

Open the edit panel for a giveaway

/giveaway edit panelgiveaway

Parameter	Type	Default	Detail
`giveaway`	String	the most recent one here	Which giveaway to editautocompletes as you type: no fixed list

#giveaway-edit-panel