> ## Documentation Index
> Fetch the complete documentation index at: https://help.callaro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Contact exports

# Contact exports (CSV)

You can download your contacts as a CSV from the **Contacts** list. **Export history** (reach it from **Contacts** → **More**) lists export jobs and lets you open a job to download the file when it is ready.

## How export scope works

**Export CSV** uses the **current** list scope: the search box and any filters active on the table. It is not limited to the rows you checked off—checkmarks and “select all” options mainly change *how* the export is prepared, not a separate manual subset. Adjust filters first so the table truly represents the cohort you want in the file.

**Small and medium** lists often download right away in the browser. For **very large lists**—for example when you have turned on “select all across pages” or when the total number of matching contacts is very high—the app may create an export **job** and send you to the **Export history** detail for that run. The file may be prepared in the background; when **Download CSV** (or the equivalent) is enabled and the job shows ready, use it to save the file.

## Run an export from Contacts

1. Go to **Contacts**.
2. Set search and filters so the table matches the audience you need.
3. In the table bulk area, click **Export CSV**. The control may show a short in-progress state while the request is sent.

If the app routes you to **Export history** for a new job, stay on that page (or return later from **More** → **Export history**) until the job completes and the download is available. For very large lists, be patient if the app is still building the file in the background.

![Contacts export CSV or contact export history with download available.](https://mintcdn.com/callaro-docs/Rn-efrjnSIS1s0ID/images/contacts/contact-exports.png?fit=max\&auto=format\&n=Rn-efrjnSIS1s0ID\&q=85\&s=bc2488998aa41a5cec91066d322b8bf1)

![MEDIA: GIF — From Contacts, Export CSV, then either immediate save or history detail.](https://mintcdn.com/callaro-docs/Rn-efrjnSIS1s0ID/images/contacts/slot-01.gif?s=116ca8b374c29de72cebbbbcb5d1a008)

![MEDIA: VIDEO — Large filtered set: job on Export history, refresh until download is available.](https://mintcdn.com/callaro-docs/1fJs_sKJdgiwY8nj/media/contacts/slot-01.mp4?fit=max\&auto=format\&n=1fJs_sKJdgiwY8nj\&q=85\&s=0ef7e946131b8372e40d6aed79fb8691)

## Export history: list and detail

The list is titled **Contact exports** (or similar) and summarizes recent jobs, status, how many rows were processed, and whether a download is available. Open a row to see detail: progress, status messaging that may auto-refresh while the job is active, and an **Export details** (or similar) section with timing and file size. **File size** might show as pending until the app knows the final size.

When the file is ready, use **Download CSV** on the detail page, or the download action in the list row, depending on what the screen shows for that state.

## Common mistakes

* Exporting when search and filters are not the cohort you wanted—the export always reflects the active table query at the time you click.
* Expecting an instant file when the app opened **Export history** for a job—wait for a completed, ready state and a visible download action.

## Custom fields and segments

To export meaningful columns, align your [Custom fields](https://help.callaro.ai/contacts/custom-fields-for-contacts.md) and [Filters and segments](https://help.callaro.ai/contacts/contacts-list-filters-and-segments.md) with the operational slice you need; then export with those filters active.

**Next: make exports meaningful**

Define custom fields and segments so each export matches a clear operational slice.

* [Custom fields](https://help.callaro.ai/contacts/custom-fields-for-contacts.md)
* [Segments](https://help.callaro.ai/contacts/contacts-list-filters-and-segments.md)
* [Campaign reporting](https://help.callaro.ai/campaigns/campaign-reporting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.