> For the complete documentation index, see [llms.txt](https://docs.moodly.education/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.moodly.education/features/classroom-management/bulk-add-learners.md).

# Bulk Add Learners

## Process

Moodly provides a bulk add feature which allows you to quickly populate classrooms using a CSV file.

From the side menu select "Manage Class".

Select "Bulk Add" from the top right corner of the table.

<figure><img src="/files/13NHrPRwUsFhcrcoV0jw" alt=""><figcaption></figcaption></figure>

From the bulk add screen, either drag your csv onto the area or click the area and select your csv file.

<figure><img src="/files/R1g1pD3vC8k9Ycg3FEsp" alt=""><figcaption></figcaption></figure>

On the next screen, if your csv contains header (i.e. name, gender) make sure the "Data has headers" check box is selected

<figure><img src="/files/vKZQTqD8dPfYQjpe9pAf" alt=""><figcaption></figcaption></figure>

Otherwise, unselect and click "Choose Columns"

{% hint style="info" %}
Ethnicity and Free school meals are optional
{% endhint %}

We now need to map the CSV column to the Moodly data.

Simply drag the column to the corresponding data, in the below example&#x20;

|   |                   |
| - | ----------------- |
| A | Name              |
| B | Gender            |
| C | Ethnicity         |
| D | Free School Meals |

<figure><img src="/files/CPvxdTzdAr85H0GSJXL4" alt=""><figcaption></figcaption></figure>

Finally select Import.

Please wait for the "Finish" button to appear.

If there are any data errors, a table will be displayed with the problems.

## Supported CSV Values

### Name&#x20;

Any Text

### Gender

Male, Female, male, female

### Free School Meals (Optional)

yes, no, true, false, Yes, No, True, False

### Ethnicity (Optional)

| Ethnicity Value                 |
| ------------------------------- |
| White English                   |
| White Welsh                     |
| White Scottish                  |
| White Northern Irish            |
| White Irish                     |
| White Gypsy or Irish Traveller  |
| White Other                     |
| Mixed White and Black Caribbean |
| Mixed White and Black African   |
| Mixed White Other               |
| Asian Indian                    |
| Asian Pakistani                 |
| Asian Bangladeshi               |
| Asian Chinese                   |
| Asian Other                     |
| Black African                   |
| Black African American          |
| Block Caribbean                 |
| Black Other                     |
| Arab                            |
| Hispanic                        |
| Latino                          |
| Native American                 |
| Pacific Islander                |
| Other                           |

### Data issues

If you process a file with incorrect data, like the example blow, after pressing import you will be presented with an errors grid:&#x20;

```
Name,Gender,Ethnicicy,FSM
Learner 1,invalid,White Welsh,yes
Learner 2,female,,invald
Learner 3,female
```

<figure><img src="/files/Co8OqyJqPnonBvWG4fWi" alt=""><figcaption></figcaption></figure>

The errors grid will tell you which rows in the CSV are invalid and which Moodly data element it refers to.