Export contacts to CSV

Contacts, lists & segmentsUpdated

Download your contacts as a CSV, filtered to whatever the table is showing.

Click Export on the Contacts page to download your contacts as a CSV. The file matches whatever the page is filtered to, so filter first and you get exactly what you’re looking at. A list’s own page has its own Export button, pre-filtered to that list.

Up to 10,000 contacts download straight away. Above that, EmailFig builds the file in the background and emails you a download link when it’s ready.

What’s in the file

One row per contact:

Column Notes
email_address
first_name, last_name
status subscribed, unsubscribed, cleaned or pending
source where the contact came from
subscribed_at
tags tag names, separated by ;
lists list names, separated by ;
one column per custom field headed with the field’s key

The tags and lists columns are for reading only: re-importing the file won’t recreate tag or list membership from them.

Re-importing an export

You can edit an exported file and import it back. Two things to know:

  • Leave the status column unmapped unless you mean to change opt-out state. It’s never mapped for you.
  • Re-importing can’t undo an opt-out. Suppressed addresses come back as cleaned, whatever the file says. See Suppressions.

Where to go next