Import Customers

Bulk import your existing customer database from a CSV file. Ideal for migrating from another system or adding historical customer data.


Preparing Your CSV File

Format your customer data in a CSV file with these columns:

ColumnRequiredNotes
nameYesFull name
emailRecommendedUsed for deduplication
phoneNoAny format accepted
addressNoStreet address
cityNoCity name
postal_codeNoZIP/postal code
notesNoInternal notes
tagsNoComma-separated

Example CSV

name,email,phone,notes,tags
John Smith,john@example.com,555-0123,Prefers morning appointments,VIP
Jane Doe,jane@example.com,555-0456,Allergic to latex,Regular
Bob Wilson,bob@example.com,555-0789,,New
Download template

Get a properly formatted template from Customers → Import → Download Template.


Importing Steps

  1. Go to Customers in the sidebar
  2. Click Import at the top right
  3. Click Choose File and select your CSV
  4. Map your columns to SeroBook fields
  5. Preview the import data
  6. Click Import to complete

Column Mapping

If your column names don't match exactly, you can map them:

  1. After uploading, you'll see a mapping screen
  2. For each SeroBook field, select the matching column from your CSV
  3. Use "Skip" for columns you don't want to import
  4. Preview shows how data will be imported

Common Mappings

  • "First Name" + "Last Name" → "Name" (will be combined)
  • "Mobile" or "Cell" → "Phone"
  • "Zip" → "Postal Code"
  • "Comments" or "Memo" → "Notes"

Handling Duplicates

Choose how to handle customers who already exist:

  • Skip duplicates – Don't import if email matches existing customer
  • Update existing – Overwrite existing data with new values
  • Create anyway – Create new record even if duplicate (not recommended)
Matching by email

Duplicates are detected by email address. Customers without email addresses cannot be deduplicated automatically.


Validation

Before importing, SeroBook validates your data:

  • Required fields – Checks name is present
  • Email format – Validates email addresses
  • Duplicates – Identifies existing customers
  • Data quality – Flags potential issues

Error Handling

If validation finds issues:

  • You'll see a list of rows with problems
  • Fix issues in your CSV and re-upload, or
  • Import valid rows only and fix errors later

Importing Tags

Include tags in your CSV to categorize customers:

  • Use a tags column
  • Separate multiple tags with commas: VIP, Regular
  • New tags are created automatically
  • Tag names are case-insensitive

After Import

Once import completes:

  • Review the import summary (created, updated, skipped)
  • Check a few random customers to verify data
  • Run duplicate detection to clean up any issues
  • Add any missing information manually
Import history

View past imports in Customers → Import → History. You can see what was imported and when.


Troubleshooting

File Won't Upload

  • Ensure file is CSV format (not Excel)
  • Check file size is under 10MB
  • Try saving as UTF-8 encoding

Data Not Mapping Correctly

  • Check for extra spaces in column headers
  • Ensure consistent formatting throughout
  • Remove any special characters from headers

Missing Data After Import

  • Check the import summary for skipped rows
  • Review validation errors
  • Verify column mapping was correct

Next Steps