Tournament Data Importer

📥

Tournament Data Importer

Import teams, speakers, adjudicators, venues, rounds, motions, and more directly into any NekoTab tournament via the REST API. Upload one or many CSV files at once.

1 Connect to your tournament

Tournament URL

Full URL of the tournament, e.g. https://nekotab.app/my-tournament/

API Token

Found at Admin → API → Your token in the tournament.

Tournament Slug

The short identifier in the URL. Leave as-is if the tournament already exists.

Tournament Name (only needed for new tournaments)

2 Select data type(s) and upload CSVs

Click a type to select the matching CSV file. You can select and upload multiple types at once.

🏫

Institutions

institutions.csv

👥

Teams

teams.csv

🎤

Speakers

speakers.csv

⚖️

Adjudicators

adjudicators.csv

🏛️

Venues

venues.csv

🔄

Rounds

rounds.csv

📋

Motions

motions.csv

🏆

Break Categories

break_categories.csv

📍

Venue Categories

venue_categories.csv

🎯

Adj Scores

scores.csv

🏷️

Speaker Categories

speaker_categories.csv

⚔️

Adj Conflicts

adjudicator_conflicts.csv

⚡

Team Conflicts

team_conflicts.csv

📐

Adj Venue Constraints

adj_venue_constraints.csv

📐

Team Venue Constraints

team_venue_constraints.csv

💬

Feedback Questions

adj_feedback_questions.csv

🔀

Switching from CalICOTab?

Import your full tournament in one click

CalICOTab exports tournament data as a .xml file. NekoTab can import it directly — teams, adjudicators, venues, ballots, motions, and draw all at once.

What gets imported:

✓ Teams & speakers

✓ Adjudicators & panels

✓ Venues & rounds

✓ Ballots & scores

✓ Motions

✓ Draw structure

Import from CalICOTab →

CSV File Format Guide

Each CSV must use a specific filename so the importer knows what type it is:

Filename	Content
`institutions.csv`	Institutions / schools
`teams.csv`	Teams + embedded speakers
`speakers.csv`	Speakers (if separate from teams)
`adjudicators.csv`	Adjudicators
`venues.csv`	Venues / rooms
`rounds.csv`	Round definitions
`motions.csv`	Motions
`break_categories.csv`	Break categories
`venue_categories.csv`	Venue category groups
`scores.csv`	Adjudicator base scores

Column headers

The first row must be a header row. Column names must match the Tabbycat API field names exactly (e.g. reference, institution, adj_core). See the CSV-Importers repo for sample files.

Getting your API Token

Open your tournament admin panel
Go to Admin → API
Copy the token shown on the page
Paste it in the API Token field above

Keep your token private. Anyone with it can modify your tournament data.