May 4, 2026
How to bulk-import existing students when you launch a dojo on a new platform
Bulk student import becomes relevant the moment a dojo moves from Excel sheets or notebooks to a dedicated platform — and already has dozens or hundreds of existing students. Re-entering them manually, one by one, would turn a transition that should take an hour into a week-long project. This guide explains how to properly prepare a bulk import and which common mistakes to avoid.
What structure should a correct import file have?
A CSV import file works best with a simple, predictable structure: one row per student, with clear columns for first name, last name, age, current belt, and, if available, the instructor's and parent's email for automatic linking. Extra, unclear, or inconsistent columns (sometimes "belt" in one language, sometimes in another, sometimes with different capitalization) are the most common source of import errors.
The safest way to prepare this file is to start from a predefined template, filled in exactly in the expected format, rather than adapting an old Excel sheet with its own structure — small formatting differences (an extra comma, a stray space) can block entire rows on import.
What happens to students whose instructors or parents don't have an account yet?
A realistic import needs to handle the common case: many students come with a parent email that doesn't yet have an account in the new system. A well-designed import automatically creates these missing accounts during processing, instead of rejecting the entire row or requiring each family's account to be created manually beforehand.
This automation is the real difference between an import that takes ten minutes and one that actually requires manually creating dozens of accounts before the import itself can even start.
How do you prevent duplicates on an import with incomplete or inconsistent data?
The most common import problem isn't missing data — it's inconsistent data: the same student written as "Matei Ghinea" on one row and "Ghinea Matei" on another, from an earlier mistaken entry. An import that doesn't check for duplicates at all can create two different students for the same person, fragmenting their belt and attendance history right from the start.
The most practical solution is a quick manual review of the import results right after processing — a clear report of successfully processed rows and rejected ones, with the exact reason for rejection, not just a generic error message.
What do you do with students who don't fit the standard format?
Not every student fits perfectly into the standard import format — some don't have an instructor assigned yet, others don't have a clearly defined belt (for example, children at their first free trial class, not yet officially enrolled). A rigid import that rejects the entire file because of a few incomplete rows forces unnecessary manual cleanup before you can even begin.
A good import processes valid rows separately from problematic ones, allowing manual completion afterward only for the real exceptions, not the whole file.
Dojo Master offers a dedicated CSV import, with a clear column template, automatic creation of missing parent and instructor accounts, and a row-by-row results report — for dojos switching over from existing records without wasting time manually re-entering every student. It pairs with the regular enrollment flow for new students who arrive after the initial migration.
Request access for your dojo