Giveaway System
Create and manage giveaways with customizable embeds, role requirements, winner notifications, and reroll support through the dashboard
Overview
The giveaway system lets you run prize giveaways in your server with participation tracking, role requirements, and automatic winner selection. Navigate to Left sidebar > Giveaway on your server dashboard to configure settings and manage active giveaways. Members participate by reacting to the giveaway message, and winners are randomly selected when the timer expires.
Enabling and General Settings
Toggle the enabled switch at the top of the Giveaway settings page to activate the module.
manager_roles (multi-role picker): Roles that can manage giveaways — end, reroll, and delete them. Members with these roles have full control over all giveaways.
creator_roles (multi-role picker): Roles that can create new giveaways but cannot manage existing ones.
manager_role (role picker): A single manager role as an alternative to the multi-role picker.
allow_public (toggle, default off): Allow non-staff members to create giveaways.
show_captcha (toggle, default off): Show a CAPTCHA challenge when members try to participate, reducing bot entries.
default_extra_entries (toggle, default off): Enable extra entry support by default for new giveaways.
default_host (toggle, default off): Automatically set the giveaway creator as the displayed host.
manager_roles (multi-role picker): Roles that can manage giveaways — end, reroll, and delete them. Members with these roles have full control over all giveaways.
creator_roles (multi-role picker): Roles that can create new giveaways but cannot manage existing ones.
manager_role (role picker): A single manager role as an alternative to the multi-role picker.
allow_public (toggle, default off): Allow non-staff members to create giveaways.
show_captcha (toggle, default off): Show a CAPTCHA challenge when members try to participate, reducing bot entries.
default_extra_entries (toggle, default off): Enable extra entry support by default for new giveaways.
default_host (toggle, default off): Automatically set the giveaway creator as the displayed host.
Embed Customization
Customize the appearance of giveaway messages:
embed_color (color picker, default '#338ac4'): The accent color of the active giveaway embed.
end_embed_color (color picker, default '#f04747'): The accent color of the ended giveaway embed. Red is commonly used to clearly indicate the giveaway has concluded.
emoji (text input, default '🎉'): The reaction emoji members click to enter the giveaway. You can use any Unicode emoji or custom server emoji.
embed_color (color picker, default '#338ac4'): The accent color of the active giveaway embed.
end_embed_color (color picker, default '#f04747'): The accent color of the ended giveaway embed. Red is commonly used to clearly indicate the giveaway has concluded.
emoji (text input, default '🎉'): The reaction emoji members click to enter the giveaway. You can use any Unicode emoji or custom server emoji.
Winner and Notification Settings
Configure how winners are handled:
dm_winners (toggle, default off): Send a DM to winners when the giveaway ends, notifying them of their win.
dm_host (toggle, default off): Send a DM to the giveaway host when it ends, listing the winners.
winners_role (role picker): Automatically assign this role to giveaway winners. Useful for giving winners access to a special channel or marking them visually.
winner_message (text input, max 500 characters): A custom message included in the winner announcement.
create_message (toggle, default off): Post an additional message in the channel when the giveaway ends.
dm_winners (toggle, default off): Send a DM to winners when the giveaway ends, notifying them of their win.
dm_host (toggle, default off): Send a DM to the giveaway host when it ends, listing the winners.
winners_role (role picker): Automatically assign this role to giveaway winners. Useful for giving winners access to a special channel or marking them visually.
winner_message (text input, max 500 characters): A custom message included in the winner announcement.
create_message (toggle, default off): Post an additional message in the channel when the giveaway ends.
Creating a Giveaway
Create a new giveaway from the dashboard by filling in these fields:
channelId (channel picker): The Discord channel where the giveaway message will be posted.
prize (text input): The prize description displayed in the giveaway embed.
winnerCount (number input): How many winners will be selected when the giveaway ends.
endTime (date/time picker): When the giveaway automatically ends and winners are drawn.
requiredRoleId (role picker, optional): If set, only members with this role can participate. Leave empty to allow everyone.
After creating, the bot posts the giveaway embed in the selected channel. Members react with the configured emoji to enter.
channelId (channel picker): The Discord channel where the giveaway message will be posted.
prize (text input): The prize description displayed in the giveaway embed.
winnerCount (number input): How many winners will be selected when the giveaway ends.
endTime (date/time picker): When the giveaway automatically ends and winners are drawn.
requiredRoleId (role picker, optional): If set, only members with this role can participate. Leave empty to allow everyone.
After creating, the bot posts the giveaway embed in the selected channel. Members react with the configured emoji to enter.
Managing Giveaways
The dashboard shows all active and past giveaways for your server.
End: Manually end a giveaway before its scheduled time. Winners are immediately selected and announced.
Reroll: Select new winners for an ended giveaway. This is useful if a winner does not claim their prize or is disqualified.
The giveaway tracks all participants by user ID. Each giveaway stores its messageId, channelId, participant list, and winner list for full auditability.
End: Manually end a giveaway before its scheduled time. Winners are immediately selected and announced.
Reroll: Select new winners for an ended giveaway. This is useful if a winner does not claim their prize or is disqualified.
The giveaway tracks all participants by user ID. Each giveaway stores its messageId, channelId, participant list, and winner list for full auditability.
Tips
Use the requiredRoleId to create exclusive giveaways for members with specific roles like boosters or active members. Enable dm_winners so winners are immediately notified even if they miss the channel announcement. Set a distinctive embed_color that matches your server theme to make giveaways visually consistent. Use the reroll feature if a winner does not respond within a reasonable time. Enable show_captcha for high-value giveaways to prevent bot accounts from entering.