Contacts & lists
Add and import the people you email, group them into lists, filter them by what you know, and keep a do-not-send list.
Contacts are the people you email. Each has an email address, a name, any fields you know about them (like company or city), and the lists they're on. Lists are what you send to: a contact can be on as many as you like, and still gets one email when a broadcast goes to several of their lists.
The contact list#
- Contacts, and the Do-not-send list
- Filter by any field
- Import a CSV, or add a contact
- Quick segments
- The filters in use
- Act on the contacts you've ticked
- Search by name or email, or pick a list to see only its contacts
- Segments: All, Never emailed, Opened, Not opened and Unsubscribed
- Filters: click + Add filter, pick a field (Email, Name or any of your fields), a condition (is, is not, contains, does not contain, is empty, has a value) and a value. With two or more, choose Match all or Match any
- Sort by name, email, emails sent or last emailed
- Export CSV downloads the contacts that match, and Manage lists creates, renames and deletes lists
Acting on many contacts at once#
Tick contacts to open the action bar. To act on every contact your search and filters match, across all pages, click Select all … matching in the bar.
| Action | What it does |
|---|---|
| Add to list | Adds them to a list. Type a new name to create one |
| Remove from list | Takes them off a list. They stay contacts |
| Unsubscribe | Puts them on the do-not-send list. Each can be undone later |
| Export CSV | Downloads them |
| Delete | Removes them for good. Emails already sent stay in your broadcast history |
Adding contacts#
There are several ways in:
- Import a CSV file: a spreadsheet export works (below)
- + Add contact to add one by hand
- From your forms: visitors who fill in a form with Reply to Sender turned on are added automatically, with what they submitted
- Ask the AI Assistant: "Add these 12 people to the Workshop list", or paste a list from anywhere
- Through MCP, from Claude, ChatGPT or Cursor
Adding someone who's already a contact updates them instead of making a duplicate.
Importing a CSV#
Click Import CSV. Your file needs a header row and an email column. Up to 5,000 rows at a time. Not sure of the format? Click Download sample CSV, or paste rows straight from a spreadsheet with Or paste from a spreadsheet.
- The four steps: Choose a file, Match columns, Check, Done
- The email column
- A column matched to a field you already have
- A column that becomes a new field
- Continue to check before anything is added
Match columns. Each column is matched for you where it can be: Email Address to Email, Company Name to your existing company field. Change any of them:
- Email, First name, Last name, or Full name (split into first and last)
- One of your fields, or a new field named after the column
- Don't import to leave a column out
Check. Before anything is added, you see how many contacts are new, how many are already contacts (they're updated), which rows are invalid and why, and how many are left out because they'd go over your contact limit. Pick the lists to add them to (type a new name to create one), then click Import.
Contact details#
Click a contact to open their details.
- Subscribed, or on do-not-send
- The lists they're on
- Their fields
- Every email they've been sent, and what's still waiting
- Fields hold anything you know about the person. Use a field in an email as
{{ field_name }}, like{{ company }}. Field names are lowercase with underscores: a column called Company Name becomescompany_name - Emails lists everything they've been sent, newest first, with when they opened it, and anything still waiting to go and when. Click an email to see it as it reads for this person
- The last line says where the contact came from: a CSV import, by hand, a form, the AI Assistant or the API
Lists#
Click Manage lists to create, rename or delete lists, like Customers or Monthly news. The number beside each list shows how many people on it can be emailed. Deleting a list keeps its contacts; a series that sends to that list stops adding people from it.
Do-not-send#
The Do-not-send tab holds addresses that are never emailed, whatever lists they're on.
- The Do-not-send tab
- Add addresses yourself
- Why each address is here
- Remove an address to email it again
- People who unsubscribe land here automatically
- Add addresses yourself, one per line or separated by commas, with an optional reason like "Asked by phone"
- Remove an address to email it again. If the person unsubscribed themselves, only remove them if they've asked to hear from you again
Contacts on do-not-send don't count towards your contact limit.
NoteIf you reach your contact limit, new contacts can't be added until you raise the limit or remove some. See Limits & pricing.