Skip to content

Import Errors

Troubleshooting problems with CSV imports and HubSpot migrations.

CSV Import Failures

File Upload Rejected

Symptoms: The upload fails or the file is not accepted.

Solutions:

  1. Ensure the file is in CSV or TSV format with UTF-8 encoding
  2. Check that the file size is under 50 MB
  3. Verify the first row contains column headers
  4. Remove any special characters or encoding issues in the file name
  5. Try saving the file as CSV from your spreadsheet application again

Field Mapping Issues

Symptoms: Fields are not auto-matched correctly or mapping fails.

Solutions:

  1. Use common header names (Name, Email, Phone, Company) for auto-matching
  2. Manually map unrecognized headers to the correct Outsprint fields
  3. Create a new custom property if no matching field exists
  4. Skip columns you do not need to import

Validation Errors

Symptoms: The preview shows errors for some rows.

Solutions:

  1. Invalid email format -- check for typos or formatting issues in email addresses
  2. Missing required fields -- ensure all required fields have values in every row
  3. Duplicate records -- choose your duplicate handling strategy (skip, update, or create all)
  4. Download the error report after import to see specific row-level errors

Import Stuck or Slow

Solutions:

  1. Large imports (100,000+ records) can take several minutes -- check the progress page
  2. If you navigated away, go to Settings > Import / Export > Import History to check status
  3. If the import appears stuck, wait 15 minutes before contacting support

HubSpot Migration Issues

Cannot Connect to HubSpot

Solutions:

  1. Ensure you have Admin access in HubSpot
  2. Try the connection again -- HubSpot OAuth tokens may have expired
  3. Check that your HubSpot account has not reached API rate limits

Missing Data After Migration

Solutions:

  1. Check the migration report for skipped or failed records
  2. Verify that all desired entity types were selected in Step 2 of the wizard
  3. Activities and notes are optional -- re-run the import with them selected if needed
  4. Check field mappings -- skipped fields are not imported

Custom Properties Not Created

Solutions:

  1. Review the field mapping step -- unmapped HubSpot properties are skipped
  2. Choose "Create Property" for HubSpot custom fields you want to bring over
  3. After migration, check Settings > Custom Properties to see what was created

Pro Tip

Always review the error report after an import. You can download it from the import detail view in Import History. Most errors are caused by invalid email formats or missing required fields.

What's Next