Shopify import error · from WooCommerce
Shopify import: more than 3 options or too many variants on a WooCommerce product
A WooCommerce variable product with four attributes (Size, Color, Material, Length) or with hundreds of variations does not fit Shopify’s product model as it is. Something has to give, and it is better to choose what before the import.
Why it happens
Shopify gives each product at most three options (Option1, Option2 and Option3 in the CSV) and caps the number of variants per product: 2,048 today, after years at 100, and many themes and apps were built around that older number. WooCommerce has neither limit: a variable product can use as many attributes as you like, and every combination you create becomes a variation.
WooCommerce also keeps attributes that are not used for variations at all, shown only in the “Additional information” tab. A naive conversion turns them into options too, which pushes products over the three-option limit and creates variants nobody can buy.
How the free check finds it
For each variable product the check collects the attribute names its variations actually use. Attributes listed on the parent but used by no variation are reported as informational and kept out of the options. With more than three real options, the first two stay as they are and the rest are merged into a third (for example “Material / Length”), and the product is flagged so you can check that the merged option reads well. Two attributes with the same name are an error. A product above the variant limit is an error; above 100 variants it is a warning, because that is where some themes and apps start to break.
These are the findings the check reports for this problem, each with the lines of your file where it found them:
- Changes silently
More than 3 attributes on one product
Shopify allows 3 options per product; the extra attributes are merged into the third option so no combination is lost.
What to do: Check that the merged option reads well on the product page.
- Must fix
Two options with the same name
Shopify rejects a product whose options share a name.
What to do: Rename one of the attributes.
- Good to know
Attribute that is not a variant option
Informational attributes are not variant options in Shopify and are not migrated.
What to do: Add it to the description or as a metafield if customers need it.
- Must fix
Too many variants
Shopify rejects a product above its variant limit.
What to do: Split the product into several products.
- Changes silently
More than 100 variants
Shopify accepts it, but some themes and apps break above 100 variants.
What to do: Check the product page on your theme.
Fix it by hand
- List the products the check flags with merged options and read the merged names as a shopper would.
- For each one, choose: keep the merged option, move one attribute into the description or a metafield, or split the product into several products grouped in a collection.
- For products above 100 variants, open the product page on your theme after the import and try the variant picker on a phone.
- Put informational attributes (material, care, origin) in the description or in product metafields: they are not lost, they just should not be options.
Find this in your own export, free
Upload your WooCommerce product export (and customers, if you like). In about a minute you see every row this affects, with line numbers, before anything touches Shopify. No account, no access to your store.