/giveaway¶
Tip
This command requires the administrator permission by default.
To learn how to change this, please check the faq command.
All of the commands related to giveaways.
/giveaway create¶
Creates a reaction giveaway in your server.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
| winners | int | Number of winners, from 1 to 1000. | None |
| title | str | The giveaway title. | None |
| specific_date | End date in your configured timezone (UTC by default). | None | |
| days_hours_minutes | Duration from the scheduled start, or from now. | None | |
| description | str | Optional giveaway details. | None |
| schedule | When to post and start; omit to start immediately. | None |
/giveaway role¶
Creates a giveaway for members with a specific role.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
| role | discord.Role | Role whose members are eligible. | None |
| winners | int | Number of winners, from 1 to 1000. | None |
| title | str | The giveaway title. | None |
| specific_date | End date in your configured timezone (UTC by default). | None | |
| days_hours_minutes | Duration from the scheduled start, or from now. | None | |
| description | str | Optional giveaway details. | None |
| schedule | When to post and start; omit to start immediately. | None |
/giveaway scheduled¶
List scheduled giveaways and anything that needs your attention.
/giveaway edit-scheduled¶
Edit an unpublished giveaway; omitted fields stay unchanged.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
| schedule_id | Select a scheduled giveaway from this server. | None | |
| schedule | New posting/start date in your configured timezone. | None | |
| specific_date | New absolute end date. | None | |
| days_hours_minutes | New duration from the scheduled start. | None | |
| title | New giveaway title. | None | |
| description | New giveaway description. | None | |
| winners | New number of winners. | None | |
| role | New eligible role, for role giveaways only. | None | |
| channel | New destination channel. | None | |
| clear_description | Remove the existing description. | None |
/giveaway cancel-scheduled¶
Cancel a giveaway that has not been posted.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
| schedule_id | Select a scheduled giveaway from this server. | None |
/giveaway cancel¶
Cancels an existing giveaway.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
| message | A giveaway message link or ID. | None |
/giveaway date¶
Changes a giveaway end date.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
| message | A giveaway message link or ID. | None | |
| date | The new UTC end date. | None |
/giveaway winners¶
Changes a giveaway winner count.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
| message | A giveaway message link or ID. | None | |
| winners | Number of winners, from 1 to 1000. | None |
/giveaway title¶
Changes a giveaway title.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
| message | A giveaway message link or ID. | None | |
| title | The new giveaway title. | None |
/giveaway participants¶
Shows the current number of eligible participants.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
| message | A giveaway message link or ID. | None |
/giveaway reroll¶
Rerolls winners from current Discord eligibility.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
| message | A giveaway message link or ID. | None | |
| winners | Number of winners to reroll, from 1 to 1000. | None |