Comps.gg Documentation

Appearance

Competition Management ​

Manage all aspects of competitions from creation to winner selection.

Competitions List

Routes ​

  • /admin/competitions - List all competitions
  • /admin/competitions/new - Create new competition
  • /admin/competitions/[id] - Edit competition
  • /admin/competitions/[id]/entries - Manage competition entries
  • /admin/competitions/[id]/instant-wins - Manage instant win prizes

Competitions List ​

Route ​

/admin/competitions

Statistics ​

Competition Stats

  • Total Competitions - All competitions
  • Active - Currently running
  • Draft - Not yet published
  • Ended - Completed competitions

Features ​

  • Search - Find competitions by title
  • Filter - Filter by status (including Archived)
  • Sort - Sort by date, status, or entries
  • Actions:
    • View details
    • Edit competition
    • View entries
    • Forecast sales
    • Duplicate competition
    • Archive/Delete competition

Filtering Competitions ​

Filter competitions by status:

  • All - Show all competitions
  • Active - Currently live
  • Draft - Not yet published
  • Ended - Closed competitions
  • Archived - Hidden from public (See Archiving below)

Creating a Competition ​

Create Competition

Route ​

/admin/competitions/new

Steps ​

  1. Navigate to /admin/competitions
  2. Click "Create Competition"
  3. Fill in competition details through multi-step form:

Step 1: Basic Details ​

  • Title - Competition name
  • Description - Full competition description
  • Short Description - Brief summary

Step 2: Prize Information ​

  • Prize Title - What you're giving away
  • Prize Description - Detailed prize info
  • Prize Value - Retail value

Step 3: Media & Images ​

  • Main Image - Primary competition image (1200x800px)
  • Gallery Images - Additional prize photos
  • Thumbnail - List view image (400x300px)

Step 4: Tickets & Pricing ​

  • Ticket Price - Cost per entry
  • Max Tickets - Total tickets available
  • Max Per User - Entry limit per user
  • Min Tickets - Minimum for draw to proceed
  • Default Ticket Quantity - Pre-selected quantity in ticket selector (optional)

Step 5: Duration ​

  • Start Date - When competition goes live
  • End Date - When entries close

Step 6: Draw Settings ​

  • Draw Method - Manual, Random.org, or Instant Win
  • Number of Winners - How many winners to select
  • Auto-draw - Automatically draw on end date
  1. Review all details
  2. Click "Create Competition"
  3. Competition is created in Draft status

Editing a Competition ​

Edit Competition

Route ​

/admin/competitions/[id]

Sections ​

The edit page is organized into sections:

  • Details - Basic information
  • Content - Descriptions and rules
  • Tickets/Pricing - Entry configuration
  • Draw Settings - Winner selection method
  • Media - Images and videos
  • SEO - Meta tags and optimization
  • Advanced - Additional settings

Section Navigation ​

Use the section navigation bar to jump between sections quickly.

Sales Forecast ​

For active competitions, view sales forecast card:

Sales Forecast

  • Projected ticket sales
  • Current pace vs target
  • Days remaining
  • Trend indicators

Actions ​

  • Save Changes - Update competition
  • Publish - Make draft live
  • End Early - Close competition
  • View Live - See public page
  • Duplicate - Copy to new competition

Competition Status ​

Competitions progress through these statuses:

  • Draft - Being created, not visible to users
  • Active - Live and accepting entries
  • Ending Soon - Within 24 hours of closing
  • Ended - Closed to new entries
  • Drawing - Winner selection in progress
  • Completed - Winner announced
  • Cancelled - Cancelled (refunds processed)

Managing Entries ​

Competition Entries

Route ​

/admin/competitions/[id]/entries

Statistics ​

  • Total Entries - All ticket numbers
  • Purchased - Paid and confirmed
  • Available - Still for sale
  • Reserved - In user carts
  • Unique Entrants - Individual users

Entry List ​

View all entries with:

  • Ticket Number - Entry number
  • User - Who purchased
  • Status - Purchase status
  • Date - When purchased
  • Order ID - Associated order

Filters ​

  • Search - Find by ticket number or user
  • Status - Filter by status
  • Sort - Order by date, ticket number, or user

Create Postal Entry ​

For postal entries:

  1. Click "Create Postal Entry"
  2. Enter customer details
  3. Assign ticket number(s)
  4. Add notes
  5. Create entry

Instant Wins ​

Instant Wins

Route ​

/admin/competitions/[id]/instant-wins

Overview ​

Manage instant win prizes where users win immediately upon purchase.

Statistics ​

  • Total Prizes - All instant wins
  • Claimed - Prizes won
  • Unclaimed - Still available

Adding Prizes ​

Single Prize ​

  1. Click "Add Prize"
  2. Enter prize details:
    • Prize name
    • Prize value
    • Description
  3. Assignment method:
    • Random - Randomly assigned ticket
    • Specific - Choose ticket number
  4. Click "Create"

Bulk Add ​

Bulk Add Prizes

  1. Click "Bulk Add"
  2. Upload CSV file with:
    • Prize name
    • Prize value
    • Ticket number (optional)
    • Description
  3. Review preview
  4. Confirm import

CSV Format ​

csv
name,value,ticket_number,description
"£10 Gift Card",10,42,"Amazon gift card"
"Free Entry",5,156,"Next competition free entry"

Prize Management ​

  • View all instant win prizes
  • See claim status
  • Edit prize details
  • Remove prizes
  • Export prize list

Forecasting Tool ​

Sales Forecast

For active competitions, access forecasting:

  1. Navigate to competitions list
  2. Click "Forecast" on active competition
  3. View predictions:
    • Expected final ticket sales
    • Estimated completion date
    • Daily sales trends
    • Success probability

Use forecasting to:

  • Adjust marketing efforts
  • Optimize competition duration
  • Plan draw timing
  • Identify underperforming competitions

Duplicating Competitions ​

Duplicate Competition

Quickly create a new competition based on an existing one:

How to Duplicate ​

  1. Navigate to competition list or competition edit page
  2. Click "Duplicate" action
  3. New competition is created with:
    • All settings copied from original
    • Draft status (not live)
    • Original dates preserved (you must update manually)
    • New unique ID
    • No entries or tickets

What Gets Copied ​

  • Title (with "Copy of" prefix)
  • Description and short description
  • Prize information
  • Images and gallery
  • Ticket pricing
  • Entry limits
  • Draw settings
  • Instant win configuration (structure only, not actual prizes)

What Doesn't Get Copied ​

  • Entries and tickets
  • Instant win prizes (must be recreated)
  • Orders and sales
  • Competition status (starts as Draft)
  • Winners and draw results

Important Notes ​

  • Dates are not automatically advanced - You must manually update start and end dates
  • Review all settings before publishing
  • Update title to remove "Copy of" prefix
  • Create new instant win prizes if needed
  • Competition starts in Draft status for safety

Common Use Cases ​

  • Running seasonal competitions
  • Testing configuration changes
  • Creating competition templates
  • Reusing successful competition formats

Archiving Competitions ​

Hide completed competitions from public view while preserving data:

What is Archiving? ​

  • Competition is hidden from public competition list
  • Data is preserved - entries, winners, orders all remain
  • Competition can be viewed in admin area with "Archived" filter
  • Can be unarchived later if needed

How to Archive ​

Option 1: From Winner Manager

  1. Navigate to /admin/winners/winner-manager
  2. Find completed competition
  3. Click "Archive" button
  4. Confirm archiving

Option 2: Soft Delete

  1. Navigate to competition list
  2. Click "Delete" on competition
  3. Competition is soft deleted (archived)

Viewing Archived Competitions ​

  1. Go to /admin/competitions
  2. Use status filter
  3. Select "Archived"
  4. View all archived competitions

Difference from Deletion ​

  • Archive - Hide from public, preserve all data
  • Soft Delete - Same as archive (current behavior)
  • Hard Delete - Permanent removal (not available for competitions with orders)

Use Cases ​

  • Clean up old competitions from public view
  • Preserve historical data for records
  • Remove seasonal competitions after they end
  • Keep admin area organized

Drawing Winners ​

See the Random.org Integration guide for details on fair winner selection.

See the Winners Management guide for fulfillment tracking.

Default Ticket Quantity ​

Pre-select a ticket quantity for users when they view a competition:

Configuration ​

When creating or editing a competition:

  1. Navigate to Tickets & Pricing section
  2. Set "Default Ticket Quantity" field
  3. Enter the number you want pre-selected (e.g., 5, 10, 20)
  4. Save competition

How It Works ​

  • When users view the competition, the ticket selector shows your default quantity
  • Users can still change the quantity
  • Helps guide users toward better value bundles
  • Can increase average order size

Use Cases ​

  • Popular bundles - Pre-select your most common bundle size
  • Value offers - Default to quantity with best price per ticket
  • Promotions - Encourage higher ticket purchases
  • Simple pricing - Make checkout faster for users

Tips ​

  • Don't set too high (can discourage smaller purchases)
  • Match to your pricing strategy
  • Test different defaults to optimize conversion
  • Consider setting to your most popular purchase quantity

Tips ​

  • Use high-quality prize images
  • Set realistic ticket limits
  • Enable auto-draw for convenience
  • Monitor sales forecasts
  • Create instant wins to boost engagement
  • Use draft status while setting up
  • Test competitions before publishing
  • Keep entry limits fair