Switching Martial Arts School Software Without Losing Belt Records

Belt history is irreplaceable data in martial arts schools — a software migration that loses rank records damages student trust and triggers churn. The schools that migrate cleanly follow one rule: export everything before canceling the old platform, and verify belt records specifically before going live on the new one.

Why Is Belt History the Critical Data in Martial Arts Software Migration?

For a BJJ student with 4 years of training, their belt progression record is a professional and personal credential. A blue belt promoted to purple after 3 years has that promotion date tied to specific attendance, a specific instructor, and a specific test. If a software migration loses that record, the student has to reconstruct it from memory — or trust that it still exists somewhere.

The same applies to children in karate programs. Parents who've watched their child progress from white belt to black belt over eight years have an emotional investment in that record. Losing it is not a minor inconvenience.

What Data Must You Export Before Migrating?

Eight categories for martial arts schools — more than most other studio types because rank data requires its own export.

Student records. Name, contact info, guardian info for minors, enrollment date, emergency contact.

Belt/rank history. Current belt level, all previous belt levels, promotion dates, and — where recorded — the instructor who awarded each rank.

Attendance logs. Per-student class attendance for the last 24+ months. Required for rank verification (most systems require minimum class attendance for promotion) and loyalty program milestones.

Transaction history. All payments, tuition charges, event fees, and equipment purchases for the last 24 months.

Pack and credit balances. Remaining class credits for every active student. These are liabilities.

Recurring billing records. Every active subscription, amount, billing date, and payment method.

Medical and waiver records. Any documented conditions, injuries, or signed waivers. Check your platform's export capability for these — they're sometimes locked in a separate module.

Equipment rentals or loaner records. If your school tracks gear lent to students, export that separately.

What Is the Correct Migration Sequence?

The 6-Step Dojo Migration Protocol:

Step 1: Export all data before touching the new platform configuration. Confirm belt history is included in your export. If it's not in the standard export format, contact your current platform's support.

Step 2: Configure the new platform. Build class types, schedules, belt progression structure, and tuition products. Do not import students yet.

Step 3: Import and verify student records. Upload the CSV. Then manually verify belt records for your top 20 longest-tenured students. If those look correct, spot-check another 10% randomly.

Step 4: Parallel run. Run both platforms simultaneously for 30 days. Process billing in the old platform. Use the new platform for scheduling and check-in only.

Step 5: Billing cutover. Set up recurring billing in the new platform. Run one billing cycle to confirm charges process correctly. Cancel recurring billing in the old platform.

Step 6: Full cutover and cancellation. After confirming billing is clean, cancel the old platform. Send go-live communication to families.

How Do You Preserve Belt History in the New System?

Most modern martial arts school platforms have a belt/rank progression field in the student profile. The field should support: rank name, date awarded, and instructor name.

When importing, map your exported belt columns to these fields exactly. If your new platform uses different rank naming conventions (e.g., "Blue Belt" vs "blue_belt" vs "2 — Blue"), standardize your import file to match the new platform's expected format before uploading.

After import, verify the belt progression display for three or four long-tenured students by looking at their profiles in the new system. The visual display should show their full rank history, not just their current belt. If it only shows current rank, your import may need a configuration change.

How Do You Handle Families With Active Pack or Credit Balances?

Every student with remaining class credits is carrying a balance on your balance sheet. Those credits must migrate to the new platform at the correct amount.

Export a separate credits report from your old platform showing student name, credit balance, and expiration date. Import this as a manual credit adjustment in the new platform for each affected student. Verify the count matches your export before going live.

For families with partially used packs, send a personal confirmation: "Your remaining X classes have transferred to your account on [new platform]. Here's how to book your next class." This closes the loop proactively rather than waiting for a complaint.

What Should You Tell Families About the Switch?

Keep it simple and practical. Three messages:

2 weeks out: "We're moving to a new system on [date]. You'll need to create a new account — here's the link. Your class schedule and rank history will transfer automatically."

3 days out: "Action required: please create your account at [link] and update your payment method before [date]. If you need help, call or text [number]."

Go-live: "We're live. Book your next class here: [link]. Your history and rank records are already in your profile."

Families who don't create accounts within the first week should receive a personal outreach call from staff, not another automated email.

For the broader operations context, see the martial arts school operations manual and the martial arts school playbook. For pricing structure decisions that affect how you configure tuition in the new platform, see the martial arts membership pricing guide.