Lab Case · Platform Rule

A valid CSV that still fails a Shopify product-import check

Generic CSV syntax can be clean while a destination-specific required column is missing.

Reproducible fixture
Structure: validDelimiter: commaShopify issue: missing Title

Fixture

Handle,Vendor
blue-shirt,Acme
red-shirt,Acme

What this case proves

The file is a two-column rectangular CSV. There are no broken quotes or row-width mismatches. A generic parser can therefore call it valid CSV. The Shopify-specific checker adds another layer: Shopify's current product CSV documentation says Title is required when creating new products, and product updates require URL handle and Title.

Check Shopify's current product CSV documentation →

Run the generic checker

The file demonstrates why generic CSV validity is not the same as platform acceptance.

Run the Shopify checker

The Title header should be reported as missing.

Use actual product data

Add the required header and values from the product source or Shopify template.

Re-check before import

Confirm structure and platform headers again after editing.

Decision: CSVFixLab reports the missing header but does not manufacture titles from handles.

CSVFixLab is independent and is not affiliated with Shopify.

Measured worker results

Executed 2026-10-11 using the CSVFixLab worker handler and the downloadable fixture bytes. These are controlled synthetic tests. No customer file or live Shopify import was used.

Manual example: titles are supplied as synthetic product data. Passing offline header checks does not prove Shopify import acceptance.

Worker mode: shopify. The table records the worker's serialization decision. Diagnosis-only tool pages do not offer a repair download button.

On a small screen, scroll the table horizontally to read every column.

RunData recordsColumnsWorker permits serializationReported issues
Original fixture · utf-822Noshopify-title: A product CSV needs a Title column for product creation.
Corrected example · rechecked with Auto23NoNo issues detected by these checks

Corrected fixture

Handle,Title,Vendor
blue-shirt,Blue Shirt,Acme
red-shirt,Red Shirt,Acme

Download corrected example · Download complete measured reports

Fixture identity and test scope

Original SHA-256: 116fc878b6a7911fb709a731c3a5798af017b759fd31189c89fea57f78d93154

Corrected SHA-256: 70d38288f81b0ccd21db5541b3ce5aed20dfc286adff02152d61643df3aa2690

Node v24.19.0; actual worker handler with File-compatible byte input; no Shopify live import. Record numbers refer to parsed CSV records, including the header, rather than physical lines. The test checks reported errors and, for automatic conversions, equality of the parsed field values. It does not establish compatibility with every importer.