Download the import error report

When a contact import leaves some rows behind, Omnifox builds a downloadable CSV that spells out exactly why each row failed so you can fix it and re-upload.

Jun 26, 2026

When you import contacts from a CSV file, it's normal for a few rows to be skipped: a malformed email, a row without enough data, or duplicates depending on the strategy you picked. Instead of guessing what went wrong, Omnifox hands you a downloadable error report detailing every rejected row.

When it appears

The report is only available when an import finishes with at least one error. On the final step of the import wizard (Results) you'll see three cards: Contacts Created, Contacts Updated, and Errors. If the Errors counter is greater than zero, a Failed Rows block appears right below it.

Steps to download it

  1. Go to Contacts and click Import CSV.
  2. Upload your file, map the columns, and choose the duplicate strategy (Update or Skip). Continue to the Results step.
  3. If there were errors, find the Failed Rows block. It previews the first 10 problem rows on screen.
  4. Click the Download Error Report button.
  5. A file named import-errors-YYYY-MM-DD-HHMMSS.csv downloads with two columns: Row (the row number in your original file) and Errors (the reasons it was rejected).

How to read the report

Each line in the CSV maps to a row in your original file that couldn't be imported. The Errors column lists the reasons separated by semicolons. The most common messages are:

  • Invalid email address — the value mapped to the Email column isn't a valid email.
  • No identifiable field (email, phone, or name) — the row has nothing usable to create a contact.

Fix those rows in your original file, save, and run the import again.

Verify it

Open the downloaded CSV in your spreadsheet app. The number of data rows should match the Errors counter the wizard showed. After fixing and re-importing, the Failed Rows block should no longer appear (or show fewer rows).

If it doesn't work

  • I don't see the button: the import finished with no errors, so there's nothing to download. Check the result cards.
  • The file was processed in the background: large files show Import Queued and the outcome arrives via notification. In that case the error detail is reported when the job finishes; return to the import screen once you get the alert.
  • The CSV shows garbled characters: open it specifying UTF-8 encoding in your spreadsheet app.

Tips

  • Before re-importing, keep only the corrected rows in a fresh file so you don't reprocess the ones that already went through.
  • If many errors are duplicates, switch the strategy to Update so Omnifox updates the existing contact instead of rejecting it.

Related articles

Was this helpful?

Related articles

Message us on WhatsApp