PREFLIGHT CHECK

Check Your Shopify Product CSV Before Import

Find common Shopify CSV import issues before upload. Check UTF-8, Handle, Title, prices, fulfillment service, duplicate options and image URLs in your browser.

Check CSV

🔒 Analysis runs in your browser. The CSV file itself is not uploaded to BlueprintLab.

What this tool checks

  • UTF-8 encoding
  • Handle and Title
  • Variant Price
  • Variant Fulfillment Service
  • Duplicate option combinations per Handle
  • Image Src URL

What this tool cannot verify

The tool does not claim to verify live service-side master data, account-specific state, or network reachability that cannot be established reliably in-browser. The service’s own validation remains authoritative.

How to use this tool

Check UTF-8, required fields, prices, fulfillment values, duplicate options and image URLs before Shopify import.

  1. Use Try sample to inspect the included sample.
  2. Set + Choose a CSV file Tap or click to choose. Drag & drop also works on desktop..
  3. Use Check CSV to process the input.
  4. Compare the result with your source data and return to the input to make corrections.
+ Choose a CSV file Tap or click to choose. Drag & drop also works on desktop.
.csv,text/csv

Input and settings example

Handle,Title,Variant Price,Variant Fulfillment Service,Option1 Name,Option1 Value,Image Src
sample-product,Sample product,1200,manual,Size,M,https://example.com/sample.jpg

Check a Shopify product CSV before import

Use this before a Shopify product CSV import when the file looks valid but you want to catch obvious structural and row-level problems first. It checks Title, URL handle (and legacy Handle), price, fulfillment, option combinations, and product image URLs so you can narrow down what to fix.

A Shopify product can span multiple CSV rows. Reading those rows as one product—grouped by URL handle / Handle—is usually more useful than treating every row as an independent record.

Shopify’s current headers are not identical to older templates

The current Shopify CSV uses names such as `URL handle`, `Price`, and `Product image URL`. Older templates used headers such as `Handle`, `Variant Price`, and `Image Src`, and Shopify still supports legacy names. This checker recognizes both generations.

Avoid renaming Shopify columns just to make them look friendlier. Start from a current export or official template, then edit values rather than inventing your own schema.

How to read the result

A missing Title column is a template-level problem. A missing URL handle / Handle column is more nuanced: a new simple product can be created from Title alone, while updates and variant workflows depend on the handle.

Blank Price or Fulfillment service values are warnings rather than automatic failures because Shopify has defaults. The useful question is whether zero price or manual fulfillment is actually what you intended.

A practical example

For a shirt with S, M, and L variants, first inspect the three rows that share the same URL handle / Handle. The first product row should carry the Title, and the option-value combinations should be unique. Then review price and image URL issues.

Even with a clean preflight result, import a small sample first and inspect Shopify’s preview and the resulting product page. “The CSV imported” and “the catalog changed exactly as intended” are different checks.