# Student bulk import — sample files

## Files

| File | Purpose |
|------|---------|
| `student-import-sample.csv` | 8 test students (open in Excel or Google Sheets) |

## Before you import

1. **Classes must exist** — Create classes first (**School Setup** or **Academics → Classes**). In the CSV, use `classCode` as **grade + section** (e.g. `10-A`, `9-B`, `10A`) — the importer matches by grade/section even if the display name is `10th A` or `Class 10A`.
2. **School domain** — Student/parent login emails use your school domain. Set it under **Settings → School** if account creation fails.
3. **Sibling test** — Rows 1 and 5 share parent emails (`fatima.khan.parent@example.com`) to verify parent linking/dedup.

## Import steps

1. Go to **Students → Import**
2. Upload `student-import-sample.csv` (or download the template from the import page)
3. Map columns (auto-map usually works)
4. Enable **Create student/parent accounts** as needed
5. Run **Dry run**, then **Import**
6. **Download credentials CSV** immediately after import

## Excel users

- Open the `.csv` in Excel, edit, then **Save As → CSV UTF-8 (Comma delimited)** before uploading.
- Do not upload `.xlsx` directly; the importer expects CSV.