Giveaways

Giveaway Dashboard UI Guide

Learn how to navigate and use the giveaway dashboard to create, manage, and analyze giveaways.

Dashboard Overview

Access the giveaway dashboard at /dashboard/giveaways. The dashboard is divided into several key sections:

Main Dashboard Sections

•Quick Create - "Create Giveaway" button and giveaway stats overview
•Active Giveaways - List of currently running giveaways with status badges
•Create Form - Step-by-step giveaway creation interface
•Management Section - Control active giveaways and manage entries
•History & Archive - Past giveaways and winners list

Active Giveaways List

View all currently running giveaways with quick stats and management options:

Table Columns

Status BadgeColor-coded badge: ACTIVE (green), ENDED (gray), SCHEDULED (blue)
Prize NameName of the giveaway with clickable link to details
WinnersNumber of winners to be selected from this giveaway
EntriesCurrent entry count (real-time updated)
Time RemainingCountdown to giveaway end (e.g., "2h 30m")
ActionsDropdown menu with management buttons

Status Badges

ACTIVEGiveaway is running and accepting entries
SCHEDULEDGiveaway is scheduled to start at a future time
ENDEDGiveaway duration expired, awaiting winner drawing
DRAWNWinners have been selected and announced

Quick Actions Menu

Click the three-dot menu icon on each giveaway row to access:

  • • View Details - Open full giveaway information
  • • Pause/Resume - Toggle entry acceptance
  • • Extend Duration - Add more time
  • • Edit - Modify prize details and settings
  • • Draw Winners - Manually select winners
  • • View Entries - See all participants
  • • Delete - Remove the giveaway

Sorting & Filtering

  • • Click column headers to sort (by time remaining, entries, status)
  • • Status filter tabs to show ACTIVE, ENDED, or SCHEDULED only
  • • Search bar to find giveaways by prize name

Create Giveaway Form

Multi-step form for creating new giveaways with all configuration options:

Form Navigation

The form has numbered steps (Step 1, Step 2, etc.) that guide you through creation:

  • • Previous/Next buttons to navigate between steps
  • • Progress bar showing current step
  • • Can save as draft and resume later
  • • Form validation prevents submission errors

Form Fields - Step 1

Prize Name: Text input (required, max 100 chars)

Description: Textarea for extended details (optional)

Winner Count: Number slider or input (1-100)

Form Fields - Step 2

Duration: Dropdown with presets or custom input

Start Time: Immediate or date/time picker

Schedule: Toggle to enable future start

Form Fields - Step 3

Entry Method: Buttons for Reaction/Button/Command

Reaction Emoji: Emoji picker for reaction entries

Button Label: Text input for button text

Form Fields - Step 4

Level Requirement: Number input (0 to disable)

Required Roles: Multi-select SearchableSelect dropdown

Exclude Roles: Multi-select for role bans

Account Age: Number input for days

Form Fields - Step 5

Booster Multiplier: Slider for extra entries

Custom Multipliers: Role-specific settings

Add Role Multiplier: Button to add new multiplier rows

Form Fields - Step 6

Embed Color: Color picker (hex or visual)

Channel: SearchableSelect dropdown

Mention Role: Optional role to ping

Preview & Submit

Final step shows live preview of the giveaway message:

  • • Interactive preview showing embed and buttons
  • • Edit button to go back and make changes
  • • Green "Create Giveaway" button to post

Participant Management

View and manage giveaway entries and participants:

Entries Table View

Open from giveaway details. Shows all participants with:

  • • User avatar and name
  • • Entry count (with multipliers)
  • • Entry time
  • • Eligibility status (checkmark or warning)
  • • Action buttons (disqualify, view profile)

Entries Search & Filter

Search Bar: Find users by username or ID (real-time filtering)

Filter Tabs: Show All, Eligible Only, Ineligible Only

Entry Details Modal

Click a user row to see detailed information about their entry including their roles, level, account age, and reason for ineligibility if applicable.

Quick Actions

Disqualify Button: Click to remove user from winner pool (green button with black text)

View Profile: Opens Discord user profile in new window

Winner Drawing Interface

Interface for selecting and announcing winners:

Draw Winners Button

Green button with black text. Located in the giveaway details panel. Disabled if giveaway is still active.

Drawing Modal

When you click Draw Winners, a modal appears showing:

  • • Number of winners to select (confirmed)
  • • "Draw Now" button to select winners
  • • Selected winners displayed with avatars and names
  • • "Confirm & Announce" button to post results

Winner Verification

Before announcing, verify each winner:

  • • Click user to see full details
  • • Check eligibility requirements
  • • Option to exclude and redraw
  • • Hover over winners for quick info

Announcement Options

Auto Announce: Post winner message automatically to announcement channel

Custom Message: Add optional note or context to announcement

DM Winners: Toggle to send private notifications to each winner

Reroll Interface

After winners are drawn, a "Reroll Winners" button appears:

  • • Redraws from same eligible pool
  • • Shows old vs new winners comparison
  • • Posts updated announcement
  • • Maintains history of all rerolls

Giveaway History Table

View archive of all completed and past giveaways:

History Table Columns

PrizeName of the giveaway
WinnersNumber of winners for this giveaway
EntriesTotal valid entries received
EndedDate and time giveaway ended
WinnersClickable link to view winners
ActionsView details, reroll, or analytics

Search & Filter Options

  • • Search by Prize: Type to filter by giveaway name
  • • Date Range: Select start and end dates
  • • Sort Options: By date, entry count, or winner count
  • • Export: Download history as CSV

Winners List View

Click "View Winners" to see complete winner list with:

  • • Winner avatars and usernames
  • • Win rank (1st, 2nd, 3rd place)
  • • Prize details
  • • Drawing timestamp
  • • Any reroll history

SearchableSelect Dropdowns

Channel selector, role selector, and other dropdowns throughout the dashboard use SearchableSelect:

  • •Typeable: Start typing to filter options in real-time
  • •Multi-select: For role requirements, click items to add/remove
  • •Scrollable: Long lists have built-in scrolling
  • •Clear: X icon to remove selection
  • •Keyboard: Arrow keys to navigate, Enter to select

Button Styling Convention

Green Buttons (Primary Actions)

Green background with black text. Used for main actions like "Create Giveaway", "Save", "Draw Winners", "Announce".

Gray Buttons (Secondary)

Gray background. Used for less critical actions like "Edit", "View Details", "Cancel".

Red Buttons (Destructive)

Red background. Used for deletion or major actions like "Delete Giveaway", "End Early".

Dashboard Tips & Tricks

Productivity Features

  • • Keyboard shortcut Ctrl+K to quickly create new giveaway
  • • Drag giveaway cards to reorder them (if using card view)
  • • Bulk select with checkboxes for batch operations
  • • Auto-refresh every 30 seconds for real-time updates

Data & Analytics

  • • Click "Analytics" button to see engagement charts
  • • Export participation data as CSV for analysis
  • • Compare metrics across multiple giveaways
  • • Track user win history and badges

Troubleshooting

  • • If entries aren't updating, click "Refresh" button
  • • Clear browser cache if UI looks broken
  • • Check browser console for error messages
  • • Ensure you have proper permissions to manage giveaways