Importing students
Excel/CSV template, validation rules, and how to fix rejected rows.
Latest
8 min
Updated 2026-07-04
On this page
Importing students
The Student Import wizard accepts .xlsx and .csv and processes files in batches of 500 rows.
Template
Download the official template from Data Management → Students → Import → Download Template.
Required columns:
registration_no (unique, string)
first_name (string)
last_name (string)
class (must match an existing class code)
dob (YYYY-MM-DD)
gender (M / F)
parent_phone (E.164 or local Ugandan format)
Optional columns include middle_name, address, religion, nationality, and up to 5 emergency contacts.
Validation rules
- Duplicate
registration_no— rejected - Unknown class code — rejected
- Invalid date — rejected
- Malformed phone — auto-normalized (with an AI hint) or rejected
Correcting rejected rows
The importer shows every rejected row with the reason. Fix in-place and re-run — successful rows are not re-imported.
Was this article helpful?