Import contacts from CSV or XLSX

SubsiMail accepts both plain CSV and Excel (.xlsx) files, with a column-mapping step in between so your spreadsheet's headers never have to match SubsiMail's field names exactly.

1. Upload the file

Go to Contacts → Import and choose your file. For .xlsx files with multiple sheets, you'll get a sheet picker; you can also set a start row if your real header row isn't row 1 (useful for exports with a title or logo row above the data).

Contacts page with the Upload contacts (CSV or Excel) section
Uploading a CSV or XLSX file

2. Map columns

Each column in your file gets its own row on the mapping screen, with a preview of its first few values so you can confirm what you're actually looking at. For each column, choose where it goes:

  • Name, Email, or Company — SubsiMail's built-in fields
  • An existing custom field
  • Create new field — adds a new custom field on the fly, named after the column header
  • Ignore this column

SubsiMail pre-suggests a mapping based on header text (a column called "E-mail" or "Company Name" maps itself), so most imports just need a quick review rather than manual mapping from scratch.

Column mapping screen with per-column dropdowns and data preview
Mapping spreadsheet columns to contact fields

3. Choose duplicate handling

If a row's email already exists in your contacts (case-insensitive match), choose whether to:

  • Skip it, leaving the existing contact untouched, or
  • Update the existing contact with the new row's values

You also choose whether imported contacts go into an existing list or a brand-new one you name on this screen.

4. Confirm

Submitting shows a summary: how many contacts were created, updated, skipped as duplicates, or skipped for missing/invalid email addresses.

Import summary banner showing created/updated/skipped counts
Post-import summary