> For the complete documentation index, see [llms.txt](https://docs.cymbal.co/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cymbal.co/help/contacts/uploading-contacts.md).

# Uploading Contacts

This page shows you how to upload contacts into Cymbal to increase your audience

Upload a CSV of contacts to add them to your Cymbal audience.

## Format your CSV

You can map columns during the upload, so your headers don't have to match exactly. Here's an example of a correctly formatted file:

| Full name  | First name | Last name | Email address       | Phone number    | Tags                  | Genres             | Address           | Birthday    |
| ---------- | ---------- | --------- | ------------------- | --------------- | --------------------- | ------------------ | ----------------- | ----------- |
| John Smith | John       | Smith     | <example@email.com> | +1-234-567-8910 | "Top Spenders", "VIP" | "Dance/Electronic" | San Francisco, CA | Jan 1, 1990 |

### Supported date formats

When your CSV includes dates, such as birthdays, Cymbal supports these formats:

* **2006-01-02**: international standard (ISO 8601)
* **2006/01/02**: international standard with slashes
* **02 Jan 2006**: day first, abbreviated month
* **2 Jan 2006**: day first, no leading zero
* **January 2, 2006**: US-style written date
* **Jan 2, 2006**: US-style with abbreviated month
* **01/02/2006**: US short format (MM/DD/YYYY)

## How to upload contacts

{% stepper %}
{% step %}
Go to the **Audience** → [Contacts](https://manager.cymbal.co/contacts) tab.
{% endstep %}

{% step %}
Select **Add contacts** in the top right.
{% endstep %}

{% step %}
Select **Upload CSV**.
{% endstep %}

{% step %}
Upload your file by selecting **Choose a file**, or drag and drop the file onto the screen.
{% endstep %}

{% step %}
Choose how to handle **Email** and **Text subscriptions**, then select **Continue**:

* **Subscribe everyone**: marks all contacts as subscribed, even if they previously opted out. This option is only available for email.
* **Subscribe only if not opted out**: adds contacts without re-subscribing anyone who unsubscribed.
* **Unsubscribe everyone**: marks all contacts as unsubscribed.
* **Unsubscribe only if not subscribed**: unsubscribes only contacts who aren't already subscribed.
* **Don't change subscription**: keeps each contact's current subscription status.
  {% endstep %}

{% step %}
Map your CSV columns to **Cymbal attributes**, then select **Continue**:

* The left column shows your CSV column names.
* The middle column is where you assign each one to a Cymbal field, such as email, phone, first name, or last name.
* The right column previews your CSV data so you can check it's accurate.
  {% endstep %}

{% step %}
Add **tags** or **lists** to organize the contacts, then select **Continue**:

* **Tags** are internal only. Your customers can't see them. Use them for segmentation and tracking.
* **Lists** can be public or private. Customers can subscribe to or unsubscribe from public lists. Use them to manage preferences.
  {% endstep %}

{% step %}
Cymbal processes your CSV. This can take a few minutes. Your audience size updates once it's done.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Only contacts who have given explicit consent may receive emails or texts.
{% endhint %}

## Related

* [Uploading Unsubscribed Contacts](https://docs.cymbal.co/help/contacts/uploading-unsubscribed-contacts)
* [Suppressing Contacts](https://docs.cymbal.co/help/contacts/suppressing-contacts)
* [How to Search for Specific Contacts](https://docs.cymbal.co/help/contacts/how-to-search-for-specific-contacts)
* [Tags](https://docs.cymbal.co/help/segmentation/tags)
