Export contacts to CSV
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 table is showing (status tab, search and filters), so filter first and you get exactly what you’re looking at. A list’s own page has an Export button too, already 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 | |
suppressed | yes if the address is on your suppression list or blocked platform-wide |
suppression_reason | hard_bounce, soft_bounce, complaint, unsubscribe or manual |
tags | tag names, separated by ; |
lists | lists they’re subscribed to |
pending_lists | lists they haven’t confirmed yet |
unsubscribed_lists | lists they opted out of |
| one column per custom field | headed with the field’s key |
Check suppressed before using the file anywhere else: a contact can read subscribed and still be suppressed, and EmailFig never mails them. A cell that starts with =, +, - or @ is prefixed with an apostrophe so spreadsheets don’t run it as a formula.
Re-importing an export
You can edit an exported file and import it back. Two things to know:
- Leave
statuson Skip unless you mean to change opt-outs. It’s never matched for you. The suppression, tag and list columns aren’t imported. - Re-importing can’t undo an opt-out. Suppressed addresses come back unsubscribed or cleaned, whatever the file says. See Suppressions.