> For the complete documentation index, see [llms.txt](https://help.steeple.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.steeple.com/en/administration/import-collaborateurs.md).

# How do I bulk import employees?

### Overview

The import feature allows you to add or synchronize employees in bulk from a file, without having to add them one by one.

### How it works

#### Step 1 — Processing history

From the employee administration, go to the page **Import** which lists the history of previous synchronizations.

#### Step 2 — Choose the import type

Select the operation type: **add**, **deletion** or **mirror synchronization**.

#### Step 3 — Upload the file

Upload the Excel or CSV file containing the employees.

#### Step 4 — Review the alerts

The system analyzes the file and displays an alert report**alerts** about the anomalies detected (invalid rows, missing fields, etc.).

#### Step 5 — Check the analysis

An analysis report**analysis** details the operations that will be performed (creations, updates, deletions).

#### Step 6 — Start execution

Confirm to launch the **runner** which applies the operations. The status is updated live.

#### Types of operations

* **Add** (upsert): create new employees or update existing ones
* **Deletion** (delete): remove employees
* **Mirror synchronization** (mirror): replace the complete list — employees missing from the file are removed

#### Test mode (dry run)

It is possible to run a simulation before actually executing the changes. Test mode displays a report of the planned operations without applying them.

#### Message tracking

Each synchronization operation generates tracking messages indicating the result for each employee (success, error, etc.).

### Alternative: SCIM provisioning

For automatic and continuous synchronization with a corporate directory (Azure Active Directory, Okta, etc.), see the article "Automatic employee provisioning (Provisioning / SCIM)".

### What the assistant can do

The assistant cannot launch a bulk import. It can explain how it works and guide you to the administration interface. With the Administration scope, the assistant can add employees one by one.