# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.moodly.education/features/classroom-management/bulk-add-learners.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.