Troubleshooting
    4 min read

    Lead Import Errors

    Fix common CSV import issues

    Lead Import Errors

    Troubleshoot and fix common lead import problems.

    Common Errors

    "Invalid CSV format"

    Cause: File isn't proper CSV format

    Fix:

  1. Open in Excel/Google Sheets
  2. Save As → CSV (Comma delimited)
  3. Ensure UTF-8 encoding
  4. Try importing again

    5. "Required field missing"

    Cause: Contact Name or Company Name column not mapped

    Fix:

  5. Check your field mapping
  6. Ensure required columns have data
  7. Map to correct SalesOS fields

    8. "Duplicate entries skipped"

    Cause: Leads with same email already exist

    This is normal behavior. SalesOS prevents duplicates by email.

    Options:

  8. Skip duplicates (default)
  9. Update existing records
  10. Create duplicates (not recommended)

    11. "Row X has invalid email"

    Cause: Email format is incorrect

    Fix:

  11. Check row X in your CSV
  12. Correct the email format
  13. Remove any extra characters
  14. Re-import

    15. File Requirements

    RequirementLimit
    File sizeMax 10MB
    Row countMax 10,000
    FormatCSV (comma-separated)
    EncodingUTF-8

    Best Practices

  15. Preview before importing
  16. Start with a small test file
  17. Keep a backup of original data
  18. Review the import summary

    19. Was this article helpful?

    Related Articles

    Importing Leads from CSV

    Bulk import leads from spreadsheets and CSV files

    How to Create Your First Lead

    Learn how to add and manage leads in SalesOS

    import
    CSV
    errors
    troubleshooting