Skip to main content
Documentation

Creating Competitions

Step-by-step guide to setting up competitions on Tabletop League.

Starting a New Competition

  1. Go to your organization page (/o/your-slug)
  2. Click Create Competition
  3. Fill in the basic details and configure your settings

Basic Settings

Competition Details

  • Name — clear, descriptive title (3–100 characters)
  • Slug — URL-friendly identifier (auto-generated from name, editable)
  • Description — rules, prizes, schedule, and any other info players need
  • Game System — which tabletop game this competition is for
  • Rules URL — link to an external rules document (optional)
  • Banner Image — promotional graphic for the competition page

Competition Type

Choose the structure that fits your event:

  • Tournament — structured rounds with brackets (Swiss, elimination, etc.)
  • League — ongoing seasonal play
  • Ladder — continuous ranked play with tier-based matchmaking
  • Open — freeform play where participants create their own matches

Dates

  • Start Date — when the competition begins
  • End Date — when it concludes (leave blank for ongoing events)

Visibility

  • Public — listed in the competition browser, anyone can view
  • Private — only accessible via direct link or invitation

Registration Settings

Control how players join your competition:

  • Registration Enabled — toggle on/off
  • Registration Window — set open and close dates
  • Min/Max Participants — cap the field size or set a minimum
  • Team Size — set to 1 for individual play, or higher for team events
  • Require Approval — organizer must review and approve each registration

Custom Registration Questions

Add questions to the registration form for collecting extra info (army lists, dietary needs for in-person events, etc.):

  • Set question text and type
  • Mark as required or optional
  • View answers when reviewing pending registrations

Match Verification

Choose how match results are confirmed:

| Mode | How it works | |------|-------------| | Required (default) | The opponent must confirm the reported result before it's finalized | | None | Results are accepted immediately on submission |

Stages

Every competition needs at least one stage. Stages define the format and rules for a section of your competition.

For single-format events, create one stage. For multi-format events (e.g., group stage into playoffs), create multiple stages in sequence.

See Stages & Formats for details on configuring stages.

Game Configuration

If your game system supports it, you can configure:

  • Entity Pool — which characters, maps, units, etc. are legal in this competition
  • Draft Rules — pick/ban sequences and phases for pre-match drafts

Access these from the Game Config tab in your competition's manage area.

Setup Checklist

Your competition dashboard shows a setup checklist to track what's configured:

  • Basic details (name, type)
  • Dates set
  • Registration configured
  • Game entities selected (if applicable)
  • Draft rules configured (if applicable)
  • At least one stage created
  • At least 2 participants registered

Complete all items before publishing your competition.

Publishing

When your settings are ready:

  1. Review the setup checklist — all items should be complete
  2. Set the competition status to Published or Active
  3. Share the link with players
  4. Monitor registrations in your dashboard