Bulk Import via CSV
Moving from paper forms, a spreadsheet, or another platform? CSV import brings your whole roster in at once, with a validation preview that catches bad rows before anything is created.
Downloading the template
In the Tournament Manager's Competitors section you'll find two buttons: Import CSV and CSV Template. Download the template first — it contains commented instructions, the exact header row, and a sample competitor so you can see the expected format. Lines starting with # are ignored on import, so you can leave the instructions in place.
Column reference
| Column | Notes |
|---|---|
| firstName, lastName | Required. |
| dateOfBirth | Required. Format YYYY-MM-DD; must be in the past. |
| gender | Required. Male or Female (case-insensitive). |
| club | Required. Dojo or academy name — used for club separation in seeding. |
| weight | Optional. Numeric, in your tournament's weight unit. |
| rank | Optional. Belt rank, e.g. "3rd Kyu". |
| experience | Optional. Years of training, numeric. |
| events | Optional. Event names separated by semicolons, matched against your tournament's events (case-insensitive). |
| paymentStatus | Optional. One of unpaid, paid, waived, pay_later. Defaults to unpaid. |
The import flow
-
1Click Import CSV and choose your file The file is parsed in your browser — nothing is created yet.
-
2Review the preview A summary shows total rows, valid rows, and rows with problems. Each row displays its status, any errors or warnings, and a checkbox to include or skip it.
-
3Click Import Selected Selected rows are created one by one with a progress indicator, then the competitor list refreshes and auto-assignment places everyone into divisions.
Validation and errors
- Errors block a row — missing required fields, malformed or future dates of birth, invalid gender or payment status. Error rows can't be selected for import.
- Warnings don't block — for example, an event name that doesn't match any tournament event imports the competitor but skips that event.
- Duplicates are caught — a row matching an existing competitor's name and date of birth is rejected so you can't double-register anyone.
Credits
One credit per imported competitor. Imported competitors are created approved, exactly like walk-ins, and the credit check applies to the whole batch — importing 80 competitors requires 80 credits available. Check your balance before a large import.