# CSV Imports

{% embed url="<https://www.loom.com/share/ea6ff12528e747c09fee849cfae70da3?sid=4bb34e37-38d9-48b5-bea6-9e2f4374edc9>" %}

Importing people into Daisychain is simple:

* First, navigate to the "People" section of Daisychain.
* Then, click the button with three dots and click "Import CSV":

<figure><img src="https://946364910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0CFqg434FMArtC8kLCP%2Fuploads%2FpVCtb29WsDrjIh1V3zyL%2Fimage.png?alt=media&#x26;token=850d63aa-2149-4861-8eff-f07de80d0c36" alt=""><figcaption></figcaption></figure>

You'll then be guided through the four step upload process:

1. **Upload.** In this step, you'll either drag-and-drop your CSV file onto the upload area, or you can click it to select the file from a folder on your computer. Note that Daisychain only accepts CSV files (not Excel files).

{% hint style="success" %}
CSV files can include data for both [Standard Fields](https://daisychain.gitbook.io/help/managing-data/standard-fields) and [Custom Fields](https://daisychain.gitbook.io/help/managing-data/custom-fields) — but if you're importing data to Custom Fields, you'll want to create those fields before importing your CSV. Additionally, CSVs must include values for email and/or phone number for every person that you're importing into Daisychain.
{% endhint %}

{% hint style="info" %}
If you'd like to apply [Tags](https://daisychain.gitbook.io/help/managing-data/tags) to the people you're importing via CSV, tags must first be created. Values for this field should be lowercase and without any spaces — any spaces in tags should be replaced by dashes. So a "Super Volunteer" tag would get imported as "super-volunteer." Multiple tags can included in a single column, separated by commas.
{% endhint %}

2. **Map Fields.** This step is where you can look at how your fields are being mapped and identify any problems before proceeding to the actual Import step. You can adjust how fields are mapped on this step as well.

{% hint style="info" %}
If your CSV has columns that aren't relevant to Daisychain (for example, columns from a voter file export), leave them unmapped — don't try to map every column. Unmapped columns are simply ignored during import.
{% endhint %}

2. **Settings:** Decide how Daisychain handles existing contacts based on phone and email matching. If Daisychain finds matching records in your CSV that correspond to existing People in your Daisychain account (records that have identical phone number or email address as the people you're uploading) you can choose how to handle the new data:
   1. Merge new data only: Adds new fields without changing existing data.
   2. Overwrite existing data: Replaces current data with imported values.

{% hint style="warning" %}
"Merge new data only" setting applies to standard contact fields like name, address, and email. Subscription fields (such as SMS Opt-In and Email Opt-In) are handled differently — if a column is mapped to SMS Opt-In, it will opt in contacts regardless of which setting you choose here.
{% endhint %}

"Merge new data only" setting applies to standard contact fields like name, address, and email. SMS Opt-In is handled differently — if a column is mapped to SMS Opt-In, it will opt in contacts regardless of which setting you choose here.<br>

2. **Import.** On this stage you'll monitor the progress of your import, which includes two distinct phases importing the data and rebuilding the audiences. You'll also be able to view and export errors from your import.

After your import is complete, you can press "Continue" to take quick actions like adding the people you imported to a [Pathway](https://daisychain.gitbook.io/help/organizing/pathways) or targeting them in a [Campaign](https://daisychain.gitbook.io/help/texting/campaigns).

{% hint style="warning" %}
If any of rows in your CSV contain cells with invalid values (i.e. malformed email addresses, non-existent postal codes, etc.) Daisychain will reject the entire row so that you can fix the errors and re-upload those people with valid data. Any valid rows in that CSV will be processed and imported normally.
{% endhint %}


---

# 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://daisychain.gitbook.io/help/managing-data/csv-imports.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.
