Shopify CSV Import Guides

Published on online store has a non-boolean value.

Status is not one of Active, Draft, Archived.

Status has a value outside Shopify's common values.

Learn how to structure image URLs in the Shopify product CSV. Understand Image Src, Image Position, Image Alt Text columns, how to add multiple images per product, and how to avoid the most common image import failures.

Everything you need to know about the Handle field in Shopify's product CSV — what it does, the rules for valid handles, how it groups variants, and how to fix handle errors.

A complete guide to the most common Shopify CSV import errors — missing columns, invalid booleans, variant structure problems, price errors, and handle conflicts.

A column-by-column explanation of every field in the official Shopify product CSV template — what each column does, what values it accepts, and which are required.

Learn how Shopify's CSV format represents product variants using Handle grouping, Option columns, and parent/child rows. Avoid the most common mistakes that cause split products, missing variants, and import errors.

Product image URL is not a valid http(s) URL.

Image position is not a valid integer.

A row looks like an image-only row but includes SKU/Price/Options/Inventory fields.

Two rows share the same Image position for the same handle.

Image alt text exceeds Shopify's recommended limit.

Inventory quantity is not a valid integer.

Inventory quantity is negative.

Continue selling when out of stock is not DENY/CONTINUE.

Price is blank on a variant row.

Price is not a valid number.

Compare-at price is not a valid number.

Compare-at price is lower than Price.

SEO title exceeds recommended length.

SEO description exceeds recommended length.

SEO title is blank (Shopify will fall back to Title).

SEO description is blank (Shopify will fall back to Description).

Tags are blank on the main product row.

Description is present but extremely short.

Your CSV is missing a required Shopify column header.

Title is blank on at least one row.

A handle appears to contain only image rows.

Vendor is blank on the main product row.

Product category is blank on the main product row.

URL handle is blank on at least one row.

URL handle contains characters Shopify may reject.

Option2/Option3 has values while Option1 is blank.

An option name exists but the corresponding option value is blank.

Option1/2/3 names should match across rows that share a handle.

Two or more variants under the same handle share identical option values.

This row looks like variant data but Option1 value is blank.

A handle includes both "Default Title" rows and option-based variant rows.

Rows share the same handle and appear duplicated without being true variants.

Multiple Titles are used for rows sharing the same URL handle.

The same SKU appears on multiple variant rows.

The same SKU appears under different URL handles (different products).