Skip to main content

A subscriber import failed

Interpret import errors and correct your file so subscribers load successfully.

Symptom​

You upload a subscriber file (typically CSV) and the import ends with an error or a partial load. You might see a message that the file could not be read, that some rows were rejected, or that no subscribers were added. Rejected rows are usually reported with a row number and a reason so you can correct and re-upload.

Likely causes​

  • Wrong file format or encoding — the file isn't a supported type, or it was saved with an encoding that garbles accented or non-Latin characters (save as UTF-8 CSV).
  • Header row doesn't match the expected fields — column names differ from the fields you're mapping to, or the header row is missing entirely.
  • Missing or malformed email address — blank, duplicated, or invalid email values in the required column.
  • Column/data mismatch — extra commas, unquoted values containing commas, or rows with more columns than the header.
  • Values too long or wrong type — text that exceeds a field's limit, or a date/number in an unexpected format.
  • Suppressed or unsubscribed addresses — these may be skipped by design rather than failing the whole import.

Fixes​

  1. Open the error report first. Note the row numbers and reasons — fix those specific rows instead of rebuilding the file.
  2. Re-save as UTF-8 CSV from your spreadsheet tool, and confirm the first row is a clean header. (confirm the exact steps in your account)
  3. Check the email column for blanks, duplicates, and obvious typos; remove or correct them.
  4. Quote any field that contains a comma (or remove stray commas) so column counts stay consistent.
  5. Match your columns to the mapping shown during upload, trimming extra columns and long values.
  6. Re-upload the corrected file. Start with a small test file if the full one keeps failing, to isolate the bad rows.

Still stuck?​

If the file looks correct and the import still fails, download the error report and contact your platform administrator or support with the file and the reported row numbers attached.

Canonical terms: Author, Edition, Folder (Project Folder), Broadcast. See the Glossary.