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. Choose Quick start, From a template, or Custom setup, then fill in the details

Quick start gets you a fully configured event from just a name, an organization, a game system, and a format template. From a template reuses your organization's (or a public) saved competition template — every stage, scoring rule, draft config, and rules pin the template carries comes along in one submit. Custom setup is the full wizard documented below, with every option up front. See Simple Setup for the quick path and the Simple/Advanced view toggle.

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
  • Add an optional Description that appears below the question label — useful for helper text, links, or instructions (supports markdown)
  • 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