# Providing CSVs for student importing

### General CSV Import / Export

<p class="callout info">Any spreadsheets being uploaded must be exported to CSV format; The process for this will differ depending on your spreadsheet editor.</p>

The first row of an imported CSV should contain the names of the fields being imported, each row after should contain the data for a single imported record e.g:

<table border="1" id="bkmrk-first-name-surname-e" style="border-collapse: collapse; width: 100%; height: 119.188px;"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**First Name**</td><td style="height: 29.7969px;">**Surname**</td><td style="height: 29.7969px;">**Email**</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Alice</td><td style="height: 29.7969px;">Alison</td><td style="height: 29.7969px;">alice.alison@example.com</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Bob</td><td style="height: 29.7969px;">Bobson</td><td style="height: 29.7969px;">bob.bobson@example.com</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Charles</td><td style="height: 29.7969px;">Charleson</td><td style="height: 29.7969px;">charles.charleson@example.com</td></tr></tbody></table>

<p class="callout info">The importer will fail to import any column that has spaces before or after the field name in the first row.</p>

### Importing Students

The student importer takes in some extra fields to allow for the linking and/or creation of student groups on import. The fields for importing Students are:

<table border="1" id="bkmrk-first-name-surname-e-0" style="border-collapse: collapse; width: 100%; height: 106.188px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**First Name**</td><td style="height: 29.7969px;">**Surname**</td><td style="height: 29.7969px;">**Email**</td><td style="height: 29.7969px;">**Username**</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">optional</td><td style="height: 46.5938px;">optional</td><td style="height: 46.5938px;">required unless "Username" is provided</td><td style="height: 46.5938px;">required unless "Email" is provided</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-</td><td style="height: 29.7969px;">-</td><td style="height: 29.7969px;">*Must be a valid email*  
</td><td style="height: 29.7969px;">-</td></tr></tbody></table>

<table border="1" id="bkmrk-password-account-typ" style="border-collapse: collapse; width: 100%; height: 89.3907px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Password**</td><td style="height: 29.7969px;">**Account Type**</td><td style="height: 29.7969px;">**School Name**</td><td style="height: 29.7969px;">**Student Group Name**</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">required</td><td style="height: 29.7969px;">required</td><td style="height: 29.7969px;">required if linking/creating student group</td><td style="height: 29.7969px;">required if linking/creating student group</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">*Must be 8+ characters with 1 capital letter and 1 number*

</td><td style="height: 29.7969px;">*Set this field to "Student"*</td><td style="height: 29.7969px;">*If provided, must be the exact name of your school in the Wordchain admin*</td><td style="height: 29.7969px;">*If provided, must be the exact name of an existing student group in the Wordchain admin*</td></tr></tbody></table>