# Export contacts

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

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

### How to export all contacts

* Go to **Marketing > Audience > Contacts** or **CRM > Contacts**
* Click on **Export Icon on the Contacts List**

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2F3dsUDnYrrAMeLQ8Tjcm2%2FScreenshot%202025-09-10%20at%205.54.35%E2%80%AFPM.png?alt=media&#x26;token=cca6a45d-7a45-420a-a7f0-33e8cc016fd9" alt=""><figcaption></figcaption></figure>

* Select which attribute columns you want to export

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FLYg6XnHBDTF3Z66j1azt%2FScreenshot%202025-09-08%20at%205.45.23%E2%80%AFPM.png?alt=media&#x26;token=6ea65073-9f5c-4b46-a711-bc590e9aa08a" alt="" width="375"><figcaption></figcaption></figure>

* Alternatively, you can add any **attribute columns** that you would like to export in the list view.

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FCvoN5vsasmQmUdhx6Qfs%2FScreenshot%202025-09-08%20at%205.47.40%E2%80%AFPM.png?alt=media&#x26;token=d177314c-d0a4-42b5-abba-d0bc8b35b4d2" alt="" width="325"><figcaption></figcaption></figure>

3. You can also add **advanced filters** to only filter contacts which have specific criteria.  For example, any contacts whose country is United States or any contact who is in a specific list. If you export after applying these filters, only the filtered contacts will get exported

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FNSJIEQDzH6Vc68tgZtnm%2FScreenshot%202025-09-08%20at%205.47.53%E2%80%AFPM.png?alt=media&#x26;token=093ff7aa-a0b6-4993-95b6-45fbca05c33f" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
You've just exported every contact in your workspace. 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 segment or list

1. Go to **Marketing** and click **Lists or Segments** on the left-hand menu.
2. Find the segment or list you want to export, click the three dots on the right-hand side, then click **Export**.

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2Fq3cqjY7p7vqxpVpBq6sC%2FScreenshot%202025-09-08%20at%205.53.22%E2%80%AFPM.png?alt=media&#x26;token=0c1c952c-05aa-4257-8bfb-bb92c8d4a809" alt=""><figcaption></figcaption></figure>

{% 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 %}

### All Exports

In the **Contacts > Manage data > All Exports** page, you can see the status of your exports as follows. You can hover on the row and click **Download.**

* **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**

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FIqCul2Wfj8Yvhs4AxRkA%2FScreenshot%202025-09-08%20at%205.53.56%E2%80%AFPM.png?alt=media&#x26;token=41c4ec4e-b363-4ff4-a15a-1c20a2013a82" alt=""><figcaption></figcaption></figure>

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

### How to import contacts after export

Contacts can be re-imported into the platform after customizing the exported CSV file. To import, go to **Marketing** > **Contacts** > **Create Contact Arrow >** **Import from CSV**. Learn more about [importing contacts.](https://docs.bird.com/applications/audience/contacts/how-to/create-contacts)
