Comps.gg Documentation

Appearance

Winners Management ​

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

Winners Management

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 ​

Winners Table

  • Filter Options:

    • Show/hide completed fulfillments
    • Date range — filter completed draws by a specific window
    • Prize type — CASH, CREDIT, PHYSICAL, COMPETITION_TICKETS, etc.
    • Search by winner name or competition
    • Sort by date, status, or competition

  • Winner Information:

    • Competition name
    • Winner details
    • Prize information (plus any prize-choice alternative, if the winner picked one)
    • 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:
  5. Execute the draw via the Comps.gg RNG (ChaCha20 CSPRNG, Ed25519-signed, publicly verifiable)
  6. Winners are automatically assigned

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.

Prize Choices ​

Some prizes have an alternative configured — for example "£500 cash" with a "£600 site credit" alternative. After a winner is drawn, they are prompted to choose.

  • Both options visible — The winner modal shows both the primary and alternative prize.
  • Admin notification — Admins receive an email as soon as the winner picks, including which choice they made.
  • P&L uses the actual choice — Profit/loss is computed against what was actually taken, not the original prize type.
  • Cash → credit — Cash prizes with credit alternatives are no longer auto-credited — the winner always decides.
  • Ticket-bundle alternatives — If the alternative is free tickets in another competition, an order is created so the entries appear in the user's normal history.

See Wallets & Withdrawals for how choices map to wallet balances.

Inline Notes ​

Add notes to any winner record with admin attribution:

  1. Open the winner detail panel
  2. Type into the Notes field
  3. Notes are timestamped and tagged with your admin username
  4. Notes are visible to any admin reviewing the winner

Use for: ID verification status, delivery tracking, communication logs, dispute history.

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:

  • Public verification URL (Ed25519 signature)
  • 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