Import students

Overview

The CSV import tool allows you to enroll hundreds of students in minutes. This guide explains how to prepare your data and complete a successful import.

Preparing your data

Before importing, ensure your student data is organized in a spreadsheet (Excel, Google Sheets, or similar). Each row should represent one student.

CSV format

Download the template from Students → Import → Download Template. The required columns are:

Column	Required	Description
first_name	Yes	Student's first name
last_name	Yes	Student's last name
date_of_birth	Yes	Format: YYYY-MM-DD
gender	Yes	Male or Female
class_name	Yes	Must match an existing class name
guardian_name	Yes	Parent or guardian full name
guardian_phone	Yes	Guardian contact phone number
guardian_email	No	Guardian email (for parent portal)
student_id	No	Custom ID (auto-generated if empty)

Import process

1. Navigate to Students → Import
2. Upload your CSV file
3. Map the columns to the required fields
4. Review the preview — any errors are highlighted in red
5. Fix any issues and re-upload if necessary
6. Click "Import" to complete

Troubleshooting imports

• "Class not found": Ensure the class name in your CSV exactly matches an existing class in Decimal (including capitalization and spacing)
• "Invalid date format": Use YYYY-MM-DD format (e.g., 2015-03-15)
• "Duplicate student": A student with the same name and date of birth already exists
• "Missing required field": Check that all required columns have values for every row