Iris
Add to Discord

Giveaways

Run, manage, and track server giveaways.

Configure Giveaways in the dashboard

Overview#

Giveaways runs a draw from start to finish. You set the prize, the length and the number of winners, members enter with a button, and Iris picks the winners itself when the timer ends.

A draw that went wrong is recoverable. Reroll picks fresh winners, cancel stops one that should not have started, and every finished draw stays on the dashboard with its entries and its outcome.

The settings on this page are the rails: the shortest and longest a giveaway may run, how many winners are allowed, which channels a draw may be created in, and the role somebody needs to enter. Staff create draws inside those bounds without being able to fat-finger a month-long giveaway with 500 winners.

Setup#

  1. Open the dashboard and go to Engagement > Giveaways, then turn the module on.
  2. Set the duration and winner bounds under Limits.
  3. Pick a Log channel so draws and winners are recorded.
  4. Set a Required role to enter if entry should not be open to everyone.
  5. Restrict Allowed channels if draws belong in one place, then save.
  6. Create a draw from the Active giveaways tab, or with /giveaway create.

Settings#

SettingTypeDefaultWhat it does
Enable GiveawaysToggleOffThe master switch. No draw can be created while it is off.
Min duration (seconds)Number60The shortest a giveaway may run.
Max duration (seconds)Number2592000The longest a giveaway may run. The default is 30 days.
Min winnersNumber1Fewest winners a draw may have.
Max winnersNumber20Most winners a draw may have.
Log channelChannelNoneWhere draws, endings and winners are recorded.
Required role to enterRoleNoneOnly members holding it may enter. Empty means anyone can.
Allowed channelsChannelsAll channelsWhere giveaways may be created. Empty allows every channel.

Creating a draw#

These are set per giveaway, not saved as settings: the Channel it is posted in, the Prize, a Description, any Requirements written out for entrants, the Duration in minutes, hours, days or weeks, and the number of Winners.

Commands#

CommandWhat it doesRequires
/giveaway createStart a giveaway with its prize, duration and winner count.Manage Server
/giveaway end <message_id>End a draw early and pick the winners now.Manage Server
/giveaway reroll <message_id>Draw fresh winners for a finished giveaway.Manage Server
/giveaway cancel <message_id>Stop a running giveaway without picking anyone.Manage Server
/giveaway listShow the giveaways currently running.Anyone
/giveaway info <message_id>Show the detail of one giveaway.Anyone

Permissions#

PermissionWhy Iris needs it
View ChannelsSees the giveaway channel and the log channel.
Send MessagesPosts the giveaway and announces the winners.
Embed LinksThe giveaway message is an embed.
Read Message HistoryFinds the giveaway message again to end or reroll it.

What it looks like#

I
Iris APP Today at 8:53 PM
Nitro Classic

Press Enter below to join the draw.

Winners

2

Ends

in 3 days

Requirement

@Member

48 entries
I
Iris APP Today at 8:53 PM

Giveaway ended. Congratulations to the winners.

Prize

Nitro Classic

Winners

@member1, @member2

A running giveaway, and the announcement when it ends.

Tips and gotchas#

Nobody can enter.

A Required role to enter is set and most members do not hold it, or the draw was posted in a channel members cannot see.

The winner never replied.

Run /giveaway reroll <message_id> to draw again. The original result stays on the dashboard.

Can I run several at once?

Yes. /giveaway list shows everything running, and each is ended or rerolled by its own message id.

Where do I find the message id?

Turn on Developer Mode in Discord, then right click the giveaway message and copy its id. /giveaway list shows it too.

Where is the history of past draws?

On the dashboard, filtered by active, ended or cancelled, alongside the volume and entry charts.