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:

Source Rows Inside Wix Stores CSV Export
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.

  1. Relative surcharge instead of absolute variant prices: On Wix fieldType = Variant rows, an XL hoodie that costs $6 more than a $28 base hoodie only records surcharge = 6. You must sum price + surcharge into Shopify’s Price for every variant row (see variant price verification).
  2. Bare ~mv2.jpg media IDs & semicolon (;) packing: Wix often exports internal Media Manager filenames (71ec45_e43b18~mv2.jpg;…) without https://! Prepend https://static.wixstatic.com/media/ to bare filenames and split semicolon-separated galleries onto vertical continuation rows (see multi-image continuation rows).
  3. discountMode (PERCENT / AMOUNT) + discountValue: Shopify has no percentage-discount CSV column—compute the discounted checkout figure into Price and place original retail into Compare-at price.
  4. inventory = InStock / OutOfStock text strings: When numeric tracking wasn’t enabled in Wix, Wix exports text enums inside inventory. Leave Shopify’s Inventory tracker blank for InStock, or set Inventory tracker = shopify and Inventory quantity = 0 for OutOfStock.

03 / HEADER DICTIONARYWix Stores CSV to canonical Shopify field reference.

Mapping Wix Stores export headers to canonical Shopify product CSV columns
Wix Stores headerShopify CSV headerRequired transformation
handleIdURL handle (Handle)Normalize to lowercase letters, digits, and hyphens; shared across parent, variant, and photo rows.
fieldType (Product / Variant)Structural row ruleMerge single-SKU Product rows directly; for variant items, put Title & Option1 name on row 1 and option values on each variant row.
name & descriptionTitle & DescriptionKeep on primary row of each handle; leave blank on subsequent variant/image rows.
productOptionName1..3 / productOptionDescription1..3Option1..3 name & valueOn Wix’s Product row, Description1 lists all choices (S;M;L); take the individual choice from each Variant row!
price + surcharge + discountMode/ValuePrice + Compare-at priceFirst add price + surcharge, then apply PERCENT or AMOUNT markdown if active.
inventoryInventory quantityInteger stock + Inventory tracker = shopify; convert InStock to untracked blank.
productImageUrlProduct image URLPrefix bare ~mv2 filenames with https://static.wixstatic.com/media/ and split ; onto continuation rows.
collectionTagsReplace Wix semicolons (New Arrivals;Summer) with commas for Shopify collection rules.

04 / SAFE MIGRATION STEPSMove your Wix catalog to Shopify in 4 clean steps.

  1. 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.com image into Shopify’s CDN.
  2. Calculate price + surcharge & expand ~mv2 image URLs: Apply the surcharge addition, discount calculation, and semicolon URL splitting demonstrated in the converter above.
  3. 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.
  4. 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?

Ready to verify your Wix-to-Shopify CSV?

Audit headers, variant prices, and image URL syntax locally in your browser—nothing uploaded.

Open CSV Preflight Workspace ↗

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 ↗