Guides / Shopify
Shopify CSV Import Guides
43 guides covering every validation issue for Shopify CSV imports.
compliance
general
- Shopify Product Images in CSV: Image Src, Alt Text, and PositionsLearn 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.
- Shopify CSV Handle Field GuideEverything 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.
- Shopify CSV Import Errors: Common Causes and FixesA complete guide to the most common Shopify CSV import errors — missing columns, invalid booleans, variant structure problems, price errors, and handle conflicts.
- Shopify Product CSV Template ExplainedA 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.
- Shopify Product Variants Explained: CSV Structure and Common MistakesLearn 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.
images
- Invalid image URLProduct image URL is not a valid http(s) URL.
- Invalid image positionImage position is not a valid integer.Auto-fix
- Image row contains variant fieldsA row looks like an image-only row but includes SKU/Price/Options/Inventory fields.
- Duplicate image positionTwo rows share the same Image position for the same handle.
- Image alt text too longImage alt text exceeds Shopify's recommended limit.
inventory
pricing
seo
- SEO title too longSEO title exceeds recommended length.
- SEO description too longSEO description exceeds recommended length.
- SEO title missingSEO title is blank (Shopify will fall back to Title).
- SEO description missingSEO description is blank (Shopify will fall back to Description).
- Tags missingTags are blank on the main product row.
- Description is very shortDescription is present but extremely short.
structure
- Missing required columnYour CSV is missing a required Shopify column header.BlockingAuto-fix
- Missing TitleTitle is blank on at least one row.Blocking
- Product has images but no variant rowA handle appears to contain only image rows.Blocking
- Vendor missingVendor is blank on the main product row.
- Product category missingProduct category is blank on the main product row.
variant
- Missing URL handleURL handle is blank on at least one row.BlockingAuto-fix
- Invalid URL handleURL handle contains characters Shopify may reject.BlockingAuto-fix
- Option columns out of orderOption2/Option3 has values while Option1 is blank.Blocking
- Option name set but value missingAn option name exists but the corresponding option value is blank.
- Option names differ across variantsOption1/2/3 names should match across rows that share a handle.
- Variant options not uniqueTwo or more variants under the same handle share identical option values.
- Missing Option1 value for variantThis row looks like variant data but Option1 value is blank.Blocking
- Mixed "Default Title" with real optionsA handle includes both "Default Title" rows and option-based variant rows.
- Duplicate handle rows with identical variant detailsRows share the same handle and appear duplicated without being true variants.
- Same handle with different TitlesMultiple Titles are used for rows sharing the same URL handle.
- Duplicate SKUThe same SKU appears on multiple variant rows.
- Duplicate SKU across productsThe same SKU appears under different URL handles (different products).
Need help fixing your file?
Upload your Shopify CSV and get instant validation, scoring, and auto-fixes.