Migration & PlatformsWooCommerce to Shopify CSV Export Formatting Guide

Learn how to format WooCommerce CSV exports for Shopify import. Master column mapping, handle rules, and parent-child variant rows.
- ✓Complete step-by-step tutorial with verified live examples.
- ✓Compatible with WooCommerce 9.x and Shopify CSV schemas.
Why Formatting Matters for WooCommerce to Shopify CSVs
WooCommerce to Shopify CSV formatting is the systematic restructuring of raw product data columns—such as product identifiers, variant attributes, price numbers, and image paths—to conform strictly with Shopify's mandatory 50-column CSV import schema.
Improper CSV formatting leads to common import failures, including missing variant dropdowns, disconnected image galleries, and broken product handles. Using WooScraper's Shopify Exporter, this mapping is applied automatically.
Core Column Mappings: WooCommerce vs Shopify
| Data Field | WooCommerce CSV Header | Shopify CSV Mandatory Header |
| Product Identifier | ID / Slug | Handle |
| Product Title | Name | Title |
| Full Description | Description | Body (HTML) |
| Category | Categories | Type or Custom Collections |
| Variant Option Name | Attribute 1 name | Option1 Name |
| Variant Option Value | Attribute 1 value(s) | Option1 Value |
| SKU Identifier | SKU | Variant SKU |
| Price | Regular price | Variant Price |
| Discounted Price | Sale price | Variant Compare At Price |
| Main Image URL | Images | Image Src |
The Golden Rules of Shopify CSV Structure
- Uniform Product Handle: Every row representing a variation of the same product must share the exact same
Handlevalue. - Parent Row Exclusivity: The
Title,Body (HTML), andVendorfields should only be populated on the first row of a product; variation child rows should leave these columns blank to avoid duplication. - Direct Image URLs: All image links in the
Image Srccolumn must be publicly accessible direct HTTP/HTTPS URLs ending in.jpg,.png, or.webp.
Frequently Asked Questions
What happens if my images are hosted on a staging server?
Shopify downloads images at the moment of import. As long as your image URLs are publicly reachable without a login barrier, Shopify will cache them permanently on its CDN.How does WooScraper format sale prices?
WooScraper maps the WooCommerce regular price to Shopify'sVariant Compare At Price and the WooCommerce sale price to Variant Price, automatically displaying the proper strikethrough discount badge on Shopify.
Can I test CSV formatting for free?
Yes. WooScraper provides 100 products free on every scrape session so you can verify CSV structure directly in your Shopify test store.Extract Any WooCommerce or Shopify Store in Seconds
Stop copying product catalogs manually. WooScraper extracts complete catalogs, high-resolution media galleries, variation matrices, and prices directly into clean CSV, Excel, and JSON files ready for instant store migration.
Azeem Greater
Lead Developer & CreatorLead Developer & Creator of WooScraper
Full-stack software architect and creator of WooScraper. Specializing in high-performance web scrapers, reverse engineering unauthenticated e-commerce APIs, distributed proxy networks, and building reliable e-commerce catalog migration pipelines.
Related Tutorials & Articles
Continue exploring technical guides and e-commerce scraping strategies.
Migration & Platforms
Migration & PlatformsExporting Variable Products to Shopify Correctly
Migration & Platforms