# 2026-05-21 New feature: CSV connector in Soffid 4

### The new feature

<p class="callout info">The first version of the "**CSV connector**" <span style="text-decoration: underline;">has been released in Soffid 4</span>. This connector only includes the “**Customisable CSV file**” <span style="text-decoration: underline;">agent</span>. In this version, this agent is used to **generate a CSV file** as part of the Soffid synchronisation engine.</p>

### Bear in mind

Please note the following points:

- The "Customisable CSV file" agent is used to **synchronice**, <span style="text-decoration: underline;">not for load authoritative o reconcile</span>.
- **Users** who need to be created in the CSV file must **have** an **account** with that **agent**.
- Please note the **location** where the file will be created; its configuration will depend on the **operating system** and the type of Soffid **architecture/installation**

### How to configure it?

The following **components** must be installed:

- CSV plugin 4.0.0 (or higher)

### Let's look at an example

Step 1: install the **CSV plugin** from the marketplace (Add new button) in the [License and plugin](https://bookstack.soffid.com/books/soffid-4-reference-guide/page/license-and-plugin "License and plugin") page. The name of the connector is "Test plugin".

[![image.png](https://bookstack.soffid.com/uploads/images/gallery/2026-06/scaled-1680-/2oB9SLFndZ0lcQaW-image.png)](https://bookstack.soffid.com/uploads/images/gallery/2026-06/2oB9SLFndZ0lcQaW-image.png)

[![image.png](https://bookstack.soffid.com/uploads/images/gallery/2026-06/scaled-1680-/dhespCDZJ3dOM1sl-image.png)](https://bookstack.soffid.com/uploads/images/gallery/2026-06/dhespCDZJ3dOM1sl-image.png)

Step 2: **create** an **agent** of the "Customisable CSV file" type.

[![image.png](https://bookstack.soffid.com/uploads/images/gallery/2026-06/scaled-1680-/APaiPdzP2khgdjXu-image.png)](https://bookstack.soffid.com/uploads/images/gallery/2026-06/APaiPdzP2khgdjXu-image.png)

Step 3: **configure** the agent with the **mappins** you need (in the "Attribute mapping" tab).

<p class="callout info">For further information on how to configure this agent, please refer to the [CSV connector in Soffid 4](https://bookstack.soffid.com/books/connectors/page/csv-connector-in-soffid-4 "CSV connector in Soffid 4") page.</p>

[![image.png](https://bookstack.soffid.com/uploads/images/gallery/2026-06/scaled-1680-/wGHA94XZpt2v0SM4-image.png)](https://bookstack.soffid.com/uploads/images/gallery/2026-06/wGHA94XZpt2v0SM4-image.png)

Step 4. Create **CSV accounts** for users.

[![image.png](https://bookstack.soffid.com/uploads/images/gallery/2026-06/scaled-1680-/5D2TnLjvWXwEAvSc-image.png)](https://bookstack.soffid.com/uploads/images/gallery/2026-06/5D2TnLjvWXwEAvSc-image.png)

Step 5. The **accounts** created will have synchronised automatically as the **engine** is set to automatic and the **agent** is in write mode, and it is active in the **monitoring**.

The accounts.

[![image.png](https://bookstack.soffid.com/uploads/images/gallery/2026-06/scaled-1680-/HZ82yAznNziSLr0g-image.png)](https://bookstack.soffid.com/uploads/images/gallery/2026-06/HZ82yAznNziSLr0g-image.png)

The engine.

[![image.png](https://bookstack.soffid.com/uploads/images/gallery/2026-06/scaled-1680-/yqx43Nf2PizJgw15-image.png)](https://bookstack.soffid.com/uploads/images/gallery/2026-06/yqx43Nf2PizJgw15-image.png)

The agent.

[![image.png](https://bookstack.soffid.com/uploads/images/gallery/2026-06/scaled-1680-/2FWWp81w2FGprT3F-image.png)](https://bookstack.soffid.com/uploads/images/gallery/2026-06/2FWWp81w2FGprT3F-image.png)

And the monitoring.

[![image.png](https://bookstack.soffid.com/uploads/images/gallery/2026-06/scaled-1680-/gMGGVd6cwWGO37Be-image.png)](https://bookstack.soffid.com/uploads/images/gallery/2026-06/gMGGVd6cwWGO37Be-image.png)

Step 6. Now let’s **check** the CSV file. It was configured in the "/tmp/users.csv" path of the container.

[![image.png](https://bookstack.soffid.com/uploads/images/gallery/2026-06/scaled-1680-/HPjZQHTHOTP0y1wY-image.png)](https://bookstack.soffid.com/uploads/images/gallery/2026-06/HPjZQHTHOTP0y1wY-image.png)