Import An Event From CSV

The CSV Import creates an event — with all its teams and all its games in the right scoring modes — from a single upload. Useful when you're running the same event template every quarter, migrating from a spreadsheet, or setting up dozens of games at once.

From your dashboard, click Import CSV. Download the sample template, edit it, and re-upload. If anything is wrong you get a clear error and nothing is written — it's all-or-nothing.

The File Format

A single CSV with three sections. Each section starts with a # header line. The first row after each header names the columns; every following row is one record.

# Event
Name,Score Label,Date
Team Building Q4,pts,2026-09-15

# Teams
Team Number,Team Name
1,Red Dragons
2,Blue Sharks
3,Green Turtles

# Games
Name,Mode,Weight,Differential,Multiplier,Win,Draw,Loss,TopN,Participation,Tournament Format,Number of Groups,Finals Size
Marble Race,position,,10,,,,,,,,,
Trivia,direct,,,,,,,,,,,
Costume Podium,podium,,10,,,,3,1,,,,
Pickleball,competition,,,,3,1,0,,,round_robin,2,

Download the sample template (contains an example of every scoring mode).

The Event Section

Exactly one data row.

• Name — required. Up to 120 characters.
• Score Label — optional. Defaults to pts. Shown next to scores everywhere.
• Date — optional. Format YYYY-MM-DD (e.g. 2026-09-15).

The Teams Section

One row per team.

• Team Number — required. Positive integer, unique within the event (used as the visible #1, #2 in scoring UIs).
• Team Name — required. Up to 80 characters.

The Games Section

One row per game. Fill only the columns that matter for that game's mode; leave the rest blank.

Mode — required. One of:

• position — auto-rank by finishing position, uses Differential.
• quantity — auto-rank by quantity entered, uses Differential.
• direct— you type each team's points directly.
• multiplier — points = quantity × Multiplier.
• win_loss_draw — uses Win, Draw, Loss.
• custom — free-form bonus / penalty entries.
• podium — top-N finishers get ranked points; everyone else gets a flat participation score. Uses Differential, TopN, Participation.
• competition — a game-scoped tournament (round robin, etc.). Uses Win, Draw, Loss as match points and Tournament Format, Number of Groups, Finals Size.

Tournament Format (only for competition): one of round_robin, round_robin_finals, single_elimination.

Weight (any mode, optional): 0–100. When set, the game contributes rank-based points weighted by this value on the leaderboard.

Values With Commas Or Quotes

Wrap the whole value in double quotes: "Anderson, Wong & Co.". To include a literal double quote, double it inside the quoted value: "The ""Champions""".

Errors, Plan Caps, And What Happens After Upload

• The file is parsed and validated before anything is written. If any row is invalid, the whole upload is rejected with an error message and no partial event is created.
• Team count is checked against your plan. Free plan allows 6 teams per event; Pro allows 50.
• On free plan at the 3-event cap, importing will auto-archive your least-recently-edited event to make room (same behaviour as Create Event).
• Successful imports land on the event's Edit page in draft — check everything looks right before scoring.

Need a walkthrough of scoring modes to pick the right one? All 7 Scoring Modes Explained.