Winners Management

Manage competition winners, coordinate draws, and track prize fulfillment.

Route

/admin/winners

Overview

The Winners page provides a centralized location for managing all aspects of winner selection and prize fulfillment across all competitions.

Key Features

Dashboard Statistics

• Pending Draws - Competitions awaiting winner selection
• Pending Fulfillments - Prizes that need to be delivered
• Total Winners - All-time winners count

Upcoming Draws

• View competitions ready for draw
• Access draw modal directly
• See competition details and entry counts
• Quick action buttons for draw initiation

Winners Table

• Filter Options:

  • Show/hide completed fulfillments
  • Search by winner name or competition
  • Sort by date, status, or competition

• Winner Information:

  • Competition name
  • Winner details
  • Prize information
  • Draw date and verification
  • Fulfillment status

Prize Fulfillment Tracking

Track the status of prize delivery:

• Pending - Prize fulfillment not started
• In Progress - Currently being fulfilled
• Completed - Prize delivered to winner

Common Tasks

Drawing a Winner

1. Navigate to the Upcoming Draws section
2. Find the competition ready for draw
3. Click "Draw Winner" to open the draw modal
4. Configure draw settings:
   • Number of winners
   • Unique winners preference (see Unique Winners below)
5. Execute the draw via Random.org integration
6. Winners are automatically assigned

See Random.org Integration for detailed draw instructions.

Unique Winners

Control whether the same user can win multiple prizes in a single draw:

Configuration Options

Prefer Unique Winners (Recommended):

• Each winner must be a different user
• If not enough unique users have entries, system falls back to allow duplicates
• Best for fairness and prize distribution

Allow Duplicate Winners:

• Same user can win multiple prizes
• Pure random selection without uniqueness constraint
• Use when prize pool is small or entries are limited

How It Works

When Prefer Unique Winners is enabled:

1. System attempts to select winners from different users
2. Each selected winner is excluded from subsequent picks
3. If fewer unique users exist than winners needed, system allows duplicates for remaining spots

Example:

• Competition needs 3 winners
• Only 2 unique users have entries
• Result: 2 unique winners, 1 duplicate winner

When to Use Each Option

Prefer Unique Winners:

• Multiple prize tiers (1st, 2nd, 3rd place)
• Large prize pool with many entries
• Want to distribute prizes to more users
• Fairness is a priority

Allow Duplicate Winners:

• Single prize or identical prizes
• Very few participants
• Want pure random chance regardless of previous wins
• Running instant win competitions

Setting Default Behavior

Configure during:

• Competition creation
• Competition editing
• Draw execution in Winner Manager

Note: This setting only affects competitions with numberOfWinners > 1. Single-winner draws are unaffected.

Editing Winner Details

You can edit winner user information directly from the Winners page:

1. Click on a winner in the winners table
2. In the winner details modal, click "Edit User"
3. Update user information as needed:
   • Verify contact details
   • Update address for prize delivery
   • Add notes about ID verification
4. Save changes

This streamlined workflow allows you to verify winner identity and update their information without navigating to the separate Users section.

Managing Fulfillment

1. Locate the winner in the winners table
2. Update fulfillment status as prizes are processed
3. Add notes or tracking information
4. Mark as completed when prize is delivered

Verifying Draws

Each draw includes:

• Random.org verification URL
• Timestamp of draw
• Ticket numbers selected
• Full audit trail

Tips

• Process pending draws promptly to maintain user trust
• Keep fulfillment status updated
• Use filters to focus on pending items
• Verification URLs provide transparency to winners