How to export your students from Martialytics
Martialytics lets you download your student list as a CSV file yourself, without a support ticket. Here's how, what to check in the file, and how to bring it into BeltManager.
Checked against Martialytics' help center on November 7, 2026.
Export your active students
Martialytics' help article How To: Export a list of Active Students [1] gives three steps:
- Open the filters at the top of your Student List and click Reset.
- Make sure the Active Students toggle is on, then click Apply Filters.
- Click the Export button (the down-arrow icon) at the bottom of the Student List. A CSV file of your active students downloads.
Inactive students are a separate export
To export former students, Martialytics' help center [2] says to reset the filters, toggle Active Students off, toggle Inactive Students on, apply the filters, and export the same way.
You may not need that file. BeltManager imports students as active or trial, so we suggest starting with the students who train with you now. Keep the inactive file somewhere safe in case anyone comes back.
Open the file before you import it
Martialytics' help article doesn't list which columns the export contains; it describes the file only as your active student data. So open it in Excel or Google Sheets and look for:
- first and last name (in two columns, or one you need to split);
- date of birth, which BeltManager needs for every student;
- parent or guardian name, email and phone for students under 18;
- the student's current rank, if it's there, to map to
Current belt; - the program or class they attend, to map to
Group.
If a column you need isn't in the export, add it by hand in the spreadsheet before importing. Renaming headings to BeltManager's (listed below) is optional, but it means the columns match themselves.
Before you cancel Martialytics: check your cancellation terms with Martialytics in writing, and keep your billing running there until your families are set up in BeltManager.
Import the file into BeltManager
First, tidy the file
- Every student needs a date of birth. It's how BeltManager knows who is under 18 and needs a guardian.The import asks whether your file's dates are Month/Day/Year or Day/Month/Year, and starts on Month/Day/Year for a US school. It refuses a file that is clearly in the other order, and shows each student's date of birth as it will be saved, so check the preview before you import.
- Students under 18 need a guardian on the same row: a guardian name, plus a guardian email or phone. Siblings who share a guardian end up linked to the same guardian record.
- Phone numbers need the country code. Write them as
+1 555 010 0123. A number without+1is refused. If your phone column isn't in that format, set it to "Don't import" and add numbers later. - Status can only be "active" or "trial". Remove students who have left, or set the status column to "Don't import" and everyone comes in as active.
- Only bring what you need. Medical notes import if you map them, but leave out anything you don't need to run your classes safely.
- Size: up to 1,000 students, 50 columns and 2 MB per file. Split a bigger file in two.
Then import it
- Sign in to BeltManager as the school owner and open Students → Import.
- Choose your Martialytics CSV file. Want to see the expected layout first? Click Download template.
- Match your columns. BeltManager recognizes these headings automatically, and common variations such as "Parent email", "Belt", "Rank" or "Class":
First nameLast nameDate of birthEmailPhoneGuardian nameGuardian emailGuardian phoneGroupCurrent beltStatusMedical notesEmergency contact nameEmergency contact phone
First name, Last name and Date of birth are required. Set any other column to "Don't import".
- Check every row. The preview shows what will happen to each student: created, updated, skipped or an error. A student already in BeltManager with the same name and date of birth is skipped, unless you tick "Update students who are already in BeltManager". If any row has an error, nothing is saved: fix those rows and check again.
- Import. A
Groupname you don't have yet becomes a new group, and its students become its regulars. ACurrent beltyou don't have yet is added to your belts: if you teach more than one style, write it asKarate: Yellowso BeltManager knows which ladder it belongs to. - Changed your mind? You can undo an import within 24 hours from the import history on the same page.
Card details never move by CSV
No spreadsheet carries a family's saved card, and BeltManager never takes card numbers from a file. Card billing in BeltManager switches on in April 2027 for UK schools; for US schools it's coming in 2027. When it's available to your school, families add their card themselves. Keep your Martialytics billing running until you're ready to switch it off.
Stuck on a column? Send us the file's column headings (not the data) and we'll tell you how to map them.
Sources
Martialytics help center pages accessed November 7, 2026. Menus and labels change; if a step doesn't match what you see, the vendor's own help pages are the authority.