Import students from CSV
Adding students one at a time is fine for a handful. For a whole cohort, import
a CSV spreadsheet instead.
Prepare the file
Export or build a .csv file with a header row and one student per line. The
columns the importer reads:
| Column | Required | Notes |
|---|---|---|
name | Yes | The student's full name. |
email | Yes | Used as the sign-in identity. Must be unique in your academy. |
phone | Recommended | In international format (e.g. +9647XXXXXXXXX) so WhatsApp invites reach them. |
Save the file as UTF-8 so Arabic names import correctly.
Run the import
- Go to Students and open the Import action.
- Upload your CSV. The importer shows a preview and flags any rows it can't
read — a missing email, a duplicate, a malformed phone number.
- Fix flagged rows in your spreadsheet and re-upload, or import the valid rows
and add the rest by hand.
- Confirm. Students are created and, if you've connected WhatsApp, sent an
invitation to download the app.
Enroll them in a cohort
Importing creates the student records; it does not place them in a cohort. After
the import, open the cohort's roster and add the imported students, or select
them in the Students list and enroll in bulk.
Common problems
- Duplicate email — a student with that email already exists. The importer
skips the row rather than overwrite.
- Arabic shows as question marks — the file wasn't saved as UTF-8. Re-export
with UTF-8 encoding.
- No invite arrived — the phone column was empty or WhatsApp isn't connected.