Square Customers CSV Validator

🥦

Validate Complete

Validation Report Format
valid rows

Check your Square customer directory CSV export for missing columns and data format issues.

Free preview — then from $5. Save with bundles.
Free preview before you pay
Files never leave your browser
No account needed to start

Download Clean Sample

Valid Square customers export (no errors)

Clean Template

Download Error Sample

Sample with validation errors for testing

Error Example

Validation Questions Answered

What columns are required?

Only Customer ID is required. All other fields are optional.

Is this tool free?

First transactions are free to preview. Full conversions use credits based on transaction count.

How do I import a Square Customers CSV?

In Square Dashboard: Customers > Directory > Import customers. Upload a CSV, map fields, then import.

How Validation Works

1

Export from Square

Customers → Import / Export → Export Customers → Download

2

Upload CSV

Upload your Customers Export export file

3

Review Validation Results

Check your Square data for errors and warnings

Issues are flagged inline with clear fix suggestions — review and correct before you import.

Why Validate Customer Data?

Customer Directory Integrity

Customer exports require valid IDs for CRM and accounting integrations. Missing Customer ID breaks the link to transactions.

What This Tool Checks

We validate your Square customer directory: - Required columns present (Customer ID) - Name and contact fields properly formatted - Address fields valid

Your Data Stays Private During Validation

Every Row Checked

Each record is validated against format rules. Catch errors before they reach your platform.

Runs in Your Browser

Validation happens locally. Your data never leaves your browser.

GDPR Compliant

No files uploaded, no data retained. Full EU privacy compliance.

Why Validate Before Importing?

ID Validation

Checks for required Customer ID column.

Name Checking

Validates First Name, Last Name, and Company Name columns.

Contact Validation

Validates Email Address and Phone Number columns.

Address Checking

Validates Street Address, City, State, Postal Code, and Country columns.

Browser-Based

Files processed locally. Your data never leaves your computer.

Instant Results

Get validation results in seconds, even for large files.

Common Target Import Errors

Issues you might encounter when importing Source data to Target - and how we solve them

Missing Customer ID

The 'Customer ID' column is required but not found

(blank Customer ID)
CUST123456789

Square generates unique customer IDs automatically

Re-export from Square Dashboard → Customers → Export

Invalid Email Format

The 'Email Address' column contains invalid emails

john.smith or @example
john.smith@example.com

Customer emails should be valid email addresses

This is a warning - customer may have invalid email in Square

Missing Customer Name

Customer has no given name or family name

(both names blank)
Given Name: John, Family Name: Smith

At least one name field is recommended

This is a warning - customer profiles can have minimal data

More credits - more savings

Buy bundles and get up to 60% off. Perfect for recurring monthly conversions.

// PRICING //

Choose the plan that fits your needs

5,381 reviews, Excellent
Pay as you go

Just start processing on any tool page

$1/credit

Tools processing starts from 5 credits. Then 1 credit = 1k rows. No sign-up needed.

OR

Credit Bundles

$ /Credit

One-time purchase

  • No monthly commitment
  • Credits valid for one year
  • Access to all tools
  • Full file downloads

Monthly Bundles Pro

$ /Credit

Best for professionals and content creators

Annual Discount
Per month, billed annually:
Save 20% more
  • Credits refresh monthly
  • Priority processing

Purchase Credits

  • Full CSV & Excel export
  • Google Sheets export
  • Instant browser download
for credits

Visa Mastercard PayPal Apple Pay Google Pay
256-bit SSL encryption
14-day money-back guarantee
PCI DSS compliant
Powered by Paddle

Do unused credits expire?

One-time credit bundles are valid for one year. Subscription credits refresh monthly. You can use credits across any tool, anytime.

Is my data secure?

Files process entirely in your browser. We're GDPR compliant with TLS encryption.

Can I get a refund?

Yes! Full refund within 14 days if no credits used. Partial refund for unused credits anytime. Contact sup@spreadsheetbroccoli.com.

Powered by Paddle

Terms of service applies. VAT included where applicable.

Frequently Asked Questions

Your data never leaves your device. All files are processed entirely in your browser using client-side JavaScript - no data is stored on our servers or sent anywhere. There's no account to hack, no database storing your files, and no API connections to your bank or accounting software. You upload, convert, download, and we forget it immediately.
No payment or signup required. You can upload your file, see a free preview of the conversion results, and verify everything looks correct before paying anything. If it doesn't work for your files, you haven't wasted any money. We only charge when you're satisfied and ready to download the final converted file.
You can, but free scripts and AI often miss edge cases that break real-world data: missing SKUs, currency formatting quirks, tax calculation errors, or date format mismatches. We have battle-tested validators specifically designed for accounting software imports that catch these issues before they corrupt your books. Plus, you get instant browser-based conversion without installing Python or managing dependencies.
Only Customer ID is required. All other fields are optional.
These are Square-calculated lifetime value fields. They're read-only.
First transactions are free to preview. Full conversions use credits based on transaction count.
In Square Dashboard: Customers > Directory > Import customers. Upload a CSV, map fields, then import.
Square imports customer lists as .CSV. Export to CSV and align your headers to Square’s template.
Duplicates may fail import. Merge duplicates in Customer Directory, then reimport the cleaned CSV.
Those rows have issues Square can’t process. Download the error file, fix listed fields, and reimport.
Imported creates new profiles. Matched updates existing profiles when Square links a row to a customer.
Use a full number with country code (e.g., +1...). Keep formatting consistent and remove odd characters.
Yes—create the custom fields in Customer Directory first. Then include matching CSV columns when importing.