> For the complete documentation index, see [llms.txt](https://docs.bird.com/applications/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bird.com/applications/~/changes/SidqSnOUVNHmcp2wkLG7/audience-and-contacts/contacts/how-to/export-contacts.md).

# Export contacts

Contacts stored in Bird can be exported for use in other tools.

{% hint style="warning" %}
Only users with the 'Owner' role are able to export contacts.
{% endhint %}

### How to export all contacts from your directory

1. Go to **Grow Customers** > **All contacts**, and click the **Directory** tab. 
2. Click **Export**.

{% hint style="success" %}
You've just exported every contact in your directory. One the export is ready, you'll receive a notification which will take you to the [**Exports** tab](#exports-tab-overview). From here, you can click **Download** to download a CSV file containing the contacts you exported.
{% endhint %}

### How to export a specific audience or list

1. Go to **Grow Customers** and click **Audiences** or **Lists** on the left-hand side of your screen.
2. Find the audience or list you want to export, click the three dots on the right-hand side, then click **Export**.

{% hint style="success" %}
You've just exported every contact in a list or audience. One the export is ready, you'll receive a notification which will take you to the [**Exports** tab](#exports-tab-overview). From here, you can click **Download** to download a CSV file containing the contacts you exported.
{% endhint %}

### Exports tab overview

In the **Exports** tab, you can see the status of your exports as follows:

* **Export name**
  * Contact export: \<timestamp of export date>
  * Audience export: \<audience name> \<timestamp of export date>
  * List export: \<list name> \<timestamp of export date>
* **Number of contacts**
* **Status**:
  * In progress: Click **Cancel** to cancel an in progress export.
  * Completed: Click **Download** to save a CSV file of your exported contacts.
  * Canceled: Click **Retry** to start a cancelled export again.
  * Failed
* **Date of export**

{% hint style="info" %}
Exports are retained and available in Bird for 30 days.
{% endhint %}

### Export file details

By default, the export will be a CSV file containing columns for:

* Display name
* First name
* Last name
* Phone
* Email
* Created date
* Updated date

### How to import contacts after export

Contacts can be re-imported into the platform after customizing the exported CSV file. To import, go to **Grow Customers** > **All contacts** > **Directory** > **Add Contacts** > **Import from CSV**.

### FAQs

#### How do I add more attributes to my export?

In the **Directory** tab, click the 'Open columns configuration' icon on the right hand side of your screen. Check the box next to the attributes you want to export, then export your contacts.

#### What happens to a contact export when the directory is filtered through a query?

If the contact list is filtered by the audience query, the export will only contain contacts from the filtered results.&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.bird.com/applications/~/changes/SidqSnOUVNHmcp2wkLG7/audience-and-contacts/contacts/how-to/export-contacts.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.