Skip to content

Giveaways

🐸 Introduced in Frogge v0.3

Giveaways run a prize draw for your community: post one to a channel and members enter with a button, or tie it to a real Discord Scheduled Event where marking Interested is itself an entry. Winners can be picked manually any time, or left to roll themselves automatically once the giveaway's end date passes.

Quick Start

  1. Run /admin menu → Giveaways → Add. A blank giveaway opens immediately.
  2. Fill in Name, Prize, End Date, and Num Winners from the detail screen.
  3. Click Post and pick a channel: members can now enter with the Enter Giveaway button on the post.

The Giveaways home screen in Discord, listing two giveaways with Add, Modify, Remove, and a View Old Giveaways button. → A giveaway's detail screen in Discord, showing Name, Prize, End Date, Num Winners, Auto Notify Winners, Appearance, Posted to Channel, Discord Event, and Entrants.

  1. Open Giveaways → + New Giveaway, then fill in its Details (name, prize, end date, winners) on the giveaway's own page.
  2. Posting has to happen in Discord. See below.

The Giveaways list page in the Dashboard, showing total/active/rolled counts and two giveaway rows. → A giveaway's page in the Dashboard, showing its Details and Appearance forms.

Full reference

Creating & editing

A giveaway's detail screen covers Name, Prize, End Date, Num Winners (1–10), and Auto Notify Winners (DM each winner when rolled). In Discord, Appearance (Description, Thumbnail, Color, Emoji) lives on its own sub-screen reached via its own Edit button (this screen alone hit Discord's 40-component-per-message cap during development, so it was split out); the Dashboard shows Details and Appearance as two separate forms on the same page instead.

The Appearance sub-screen for a giveaway in Discord, showing Description, Thumbnail URL, Color, and Emoji fields each with their own Edit button.

Posting

Discord only: the Dashboard's giveaway page links to a live post if one exists, but notes explicitly that posting and unposting stay a Discord-only action. Post picks a channel and posts a live-updating summary (thumbnail, prize, winner count, live entry count) with an Enter Giveaway button; posting is disabled once the giveaway's been rolled.

A posted giveaway message in Discord, showing its name, description, end date, host, prize, winner/entry counts, and an Enter Giveaway button.

Discord Event integration

Optionally, Create (next to Discord Event, on either surface) creates a real Discord Scheduled Event for the giveaway. Marking Interested on that event counts as entering: Discord Event subscribers and posted-message entries merge into one always-live entrant count, re-synced every time the detail screen loads and again immediately before a roll, so the number you see is never split across two places. Only available before the giveaway is rolled, and only one Discord Event per giveaway. If one was created and then deleted on Discord's side directly, the Dashboard notices (a live status check, not a stale flag) and offers Create Discord Event again rather than pointing at a dead link.

A giveaway's linked Discord Scheduled Event, showing its name, start time, host, and Interested count.

The Discord Event, Posted to Discord, Entrants, and Roll Winners/Delete Giveaway sections on a giveaway's Dashboard page.

Rolling winners

Three ways to roll, all converging on the same result:

  • The detail screen's Roll Winners button, on either surface (re-labeled Re-Roll Winners after the first roll: Discord asks for confirmation before picking a fresh set; the Dashboard's Roll button does too, once already rolled).
  • Roll Giveaway: right-click a giveaway's posted message in Discord → Apps. Discord only.
  • Automatically: a background sweep rolls any giveaway that's passed its end date and was never manually rolled. You don't have to be online for a giveaway to conclude on time.

Rolling picks winners from the merged entrant pool, concludes or cancels the linked Discord Event (if any), and DMs each winner if Auto Notify is on: every path does all of this the same way, regardless of which one triggered it.

Old giveaways

Discord only. A rolled giveaway stays on the main Giveaways list for 3 days (so it's still easy to find right after rolling), then drops off it automatically and moves to View Old Giveaways instead: a paginated, newest-rolled-first browse of everything past that grace period, showing each one's roll date, winners, and prize, with a Details button that opens the same detail screen (Re-Roll Winners still works from there).

The View Old Giveaways screen in Discord, listing five past giveaways with their roll date, winners, and prize, each with a Details button.