Square Item Details CSV Validator

🥦

Validate Complete

Validation Report Format
valid rows

Check your Square item details 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 item details export (no errors)

Clean Template

Download Error Sample

Sample with validation errors for testing

Error Example

Square Item Details Validation Questions

What columns are required?

Only the Transaction ID column is required. It links to the Transactions export.

How does this relate to Transactions export?

Item Details contains one row per line item and joins to Transactions via Transaction ID.

Is the Square Item Details validator free?

You can preview Square Item Details validation results for free — no signup needed. Full validation reports use credits based on row count.

How Square Item Details Validation Works

1

Export from Square

Reports → Item Sales → Export CSV

2

Upload CSV

Upload your Item Sales Detail 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 Square Item Details Before Import?

Column Validation

Checks for required Transaction ID column (links to Transactions export).

Item Checking

Validates Item Name, Variation Name, SKU, and Category columns.

Quantity Validation

Validates Qty column for proper integer values.

Price Checking

Validates Gross Sales, Discounts, and Net Sales currency columns.

Browser-Based

Files processed locally. Your data never leaves your computer.

Instant Results

Get validation results in seconds, even for large files.

How People Use Square Item Details

Square's item details export concatenates modifier names into the Variation Name column with inconsistent delimiters — sometimes a comma, sometimes a pipe character. The validator flagged 85 rows where the modifier formatting would have broken our cost-of-goods calculation in QuickBooks.

Carlos R.
Restaurant Accountant · 3 Square POS locations, 1,200 items

We had an item details CSV where the Qty column contained decimal values for items sold by weight, but our inventory system expects integers for count-based items. The validator caught 43 rows mixing weight-based and count-based quantities so we could split them before the import.

Heather M.
Retail Operations Manager · validates weekly item sales exports

Square's tip allocation spreads across item detail rows in ways that throw off per-item Net Sales calculations. The validator identified 31 rows where Gross Sales minus Discounts didn't equal Net Sales because tips were embedded in the totals, letting us isolate tip amounts before feeding the data into our margin analysis.

Ryan D.
Data Analyst · reconciles item sales across 2 Square locations

Why Validate Item Details?

Line Item Accuracy

Item Details contain one row per product sold. Missing Transaction ID breaks the link to the parent transaction.

What This Tool Checks

We validate your Square item details export: - Required columns present (Transaction ID) - Item Name and SKU columns properly formatted - Quantity values are valid integers

Your Square Item Details Data Stays Private

Local Processing Engine

Your Square Item Details files stay on your device. Processing happens client-side, nothing leaves your machine.

Zero Server Storage

Your Square Item Details files are never cached, logged, or stored anywhere. Every session is ephemeral.

Privacy-First Architecture

Designed for data sovereignty. No third-party trackers or analytics touch your Square Item Details files.

Common Target Import Errors

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

Missing Transaction ID

The 'Transaction ID' is required to link items to transactions

(blank Transaction ID)
TXN001A2B3C

Transaction ID links item sales to parent transaction

Re-export from Square Dashboard → Reports → Item Sales → Detail

Missing Item Name

The 'Item Name' column is required but empty

(blank Item Name)
Latte

Every item sale must have a product name

Check for custom/open items without names in Square

Invalid Quantity

The 'Quantity' column contains non-integer values

1.5 or 'varies'
2

Quantity must be a whole number

Check for data modifications after export

Missing Gross Sales

The 'Gross Sales' column (item revenue) is required

(blank Gross Sales)
9.00

Gross Sales shows revenue per line item

Re-export ensuring all columns are included

More credits - more savings

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

Frequently Asked Questions

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 the Transaction ID column is required. It links to the Transactions export.
Item Details contains one row per line item and joins to Transactions via Transaction ID.
You can preview Square Item Details validation results for free — no signup needed. Full validation reports use credits based on row count.
Save your file as .xlsx or .csv format. The validator won't accept .xls, .xlsm, or other file types.
Some spreadsheet editors convert SKUs to scientific notation. Don't open the file directly in Excel; use a text editor instead to preserve formatting.
Items and their variations must have the same category and description. Ensure all variation names are unique within each item.
GTINs must be 8, 12, 13, or 14 digits long and contain only numbers 0-9. Remove any special characters or incorrect lengths.
Remove all commas from your file before importing. You can add them back to item names after the import is complete.
Each item in your library must have a unique name. Check for variations with identical item names and rename them.
All item variations using option sets must have both an option set name and an option value. Don't leave these fields blank.