Quick Rule Summary · Updated November 2026
Never rename Wix Stores CSV headers 1-to-1 for Shopify: you must add price + surcharge on every Variant row, prefix bare ~mv2.jpg media IDs with https://static.wixstatic.com/media/ before splitting ; galleries onto continuation rows, and clear text InStock strings so integer stock validation passes.
01 / INTERACTIVE WIX-TO-SHOPIFY CONVERTERMerge variant surcharges, prefix ~mv2 media IDs & compute discounts.
Select any Wix export pattern below—or open the live field drawer to test values from your own Wix CSV—and export a compliant UTF-8 Shopify file:
Paste or edit your own Wix product fields (live converter)
02 / THE 4 WIX STORES CSV TRAPSWhy renaming Wix headers 1-to-1 corrupts prices and images.
- Relative
surchargeinstead of absolute variant prices: On WixfieldType = Variantrows, an XL hoodie that costs $6 more than a $28 base hoodie only recordssurcharge = 6. You must sumprice + surchargeinto Shopify’sPricefor every variant row (see variant price verification). - Bare
~mv2.jpgmedia IDs & semicolon (;) packing: Wix often exports internal Media Manager filenames (71ec45_e43b18~mv2.jpg;…) withouthttps://! Prependhttps://static.wixstatic.com/media/to bare filenames and split semicolon-separated galleries onto vertical continuation rows (see multi-image continuation rows). discountMode(PERCENT/AMOUNT) +discountValue: Shopify has no percentage-discount CSV column—compute the discounted checkout figure intoPriceand place original retail intoCompare-at price.inventory = InStock/OutOfStocktext strings: When numeric tracking wasn’t enabled in Wix, Wix exports text enums insideinventory. Leave Shopify’sInventory trackerblank forInStock, or setInventory tracker = shopifyandInventory quantity = 0forOutOfStock.
03 / HEADER DICTIONARYWix Stores CSV to canonical Shopify field reference.
| Wix Stores header | Shopify CSV header | Required transformation |
|---|---|---|
handleId | URL handle (Handle) | Normalize to lowercase letters, digits, and hyphens; shared across parent, variant, and photo rows. |
fieldType (Product / Variant) | Structural row rule | Merge single-SKU Product rows directly; for variant items, put Title & Option1 name on row 1 and option values on each variant row. |
name & description | Title & Description | Keep on primary row of each handle; leave blank on subsequent variant/image rows. |
productOptionName1..3 / productOptionDescription1..3 | Option1..3 name & value | On Wix’s Product row, Description1 lists all choices (S;M;L); take the individual choice from each Variant row! |
price + surcharge + discountMode/Value | Price + Compare-at price | First add price + surcharge, then apply PERCENT or AMOUNT markdown if active. |
inventory | Inventory quantity | Integer stock + Inventory tracker = shopify; convert InStock to untracked blank. |
productImageUrl | Product image URL | Prefix bare ~mv2 filenames with https://static.wixstatic.com/media/ and split ; onto continuation rows. |
collection | Tags | Replace Wix semicolons (New Arrivals;Summer) with commas for Shopify collection rules. |
04 / SAFE MIGRATION STEPSMove your Wix catalog to Shopify in 4 clean steps.
- Export all products from Wix Dashboard: Go to Store Products → Products → More Actions → Export—and keep your Wix storefront published until Shopify finishes importing every
wixstatic.comimage into Shopify’s CDN. - Calculate
price + surcharge& expand~mv2image URLs: Apply the surcharge addition, discount calculation, and semicolon URL splitting demonstrated in the converter above. - Preflight your UTF-8 CSV in Row & Record: Open the converted file in our local browser workspace (or run a header check via our Chrome Extension ↗) to verify zero non-numeric prices or malformed image URLs.
- Run a 3-product pilot import first: Import 3 multi-variant products into Shopify Admin (Products → Import), check variant prices and gallery images on your storefront, then import the remaining catalog.
Common questions.
Why did my Wix product images fail to import into Shopify?
Wix Stores CSV exports often store bare Media Manager filenames (such as 71ec45_e43b18~mv2.jpg) separated by semicolons instead of full https:// URLs. Prepend https://static.wixstatic.com/media/ to bare filenames and split semicolon-separated entries onto shared-handle continuation rows.
How do Wix variant surcharges work when migrating to Shopify?
Wix records only the price difference (+6.00 or -3.00) in the surcharge column on Variant rows rather than the full selling price. Before importing into Shopify, calculate base price + surcharge for every variant row and place that total into Shopify’s Price column.
How do I convert Wix’s “InStock” and “OutOfStock” inventory values for Shopify?
Shopify’s Inventory quantity column rejects text strings like InStock. For untracked InStock items, leave Inventory tracker and Inventory quantity blank; for OutOfStock items, set Inventory tracker to shopify and Inventory quantity to 0.
How do I migrate Wix’s semicolon-separated collections into Shopify?
Replace semicolons with commas inside Wix’s collection column and map it to Shopify’s Tags column, then create automated Shopify collections filtered by those tags.
05 / PLATFORM MIGRATION HUBConverting from another storefront to Shopify?
Sale Price = 0.00 zero-price bug and clean Unlimited stock strings.
Etsy Listings
Etsy → Shopify Row Expander
Unpack horizontal IMAGE1..IMAGE10 and SKU1..SKU10 columns into clean rows.
WooCommerce
WooCommerce → Shopify Merger
Collapse parent variable + child variation rows and map Attribute 1..3.
Ready to verify your Wix-to-Shopify CSV?
Audit headers, variant prices, and image URL syntax locally in your browser—nothing uploaded.
Verified November 2026 against Wix Stores CSV export columns and Shopify’s multi-row Product CSV specification.
Shopify store migration documentationShopify product CSV column referenceRow & Record Chrome Extension ↗