Woo to Shopify Check

Shopify import error · from WooCommerce

WooCommerce categories to Shopify collections: why they do not come across

Your WooCommerce categories and subcategories are nowhere after the product import, and the old category pages return 404. Shopify has no store categories: it has collections and tags.

Why it happens

The Product category column in Shopify’s CSV is not your categories: it is Shopify’s standard product taxonomy (Apparel & Accessories > Clothing > Shirts), used for taxes and sales channels. Your own groupings live in collections, and collections are not part of the product CSV at all. The usual bridge is tags: every category becomes a tag, and an automated collection picks up every product with that tag.

Hierarchies need care. A product in Clothing > Shirts should show up in both collections, so both levels must become tags. The old addresses, like /product-category/clothing/shirts/, need a redirect to the new collection too, or every link and search result pointing at them breaks.

How the free check finds it

The check turns every category path into tags, one per level, and adds the WooCommerce product tags. The report lists the collections to create, each with its condition (Product tag is equal to the category), and redirects.csv sends every old category address to its /collections/ page. It reminds you to create the collections before importing the redirects, or they lead to empty pages. Tags longer than 255 characters, Shopify’s limit, are flagged.

These are the findings the check reports for this problem, each with the lines of your file where it found them:

  1. Good to know

    Categories become collections

    Shopify has no categories: each one becomes a tag, and an automated collection on that tag rebuilds it.

    What to do: Create the collections before importing the redirects, or category URLs lead to empty pages.

  2. Changes silently

    Tag over 255 characters

    Shopify does not accept tags longer than 255 characters.

    What to do: Shorten the tag.

Fix it by hand

  1. In Shopify admin, create one automated collection per category in the report, with the condition Product tag is equal to the category name.
  2. Import the products, then open a few collection pages to check them.
  3. Import redirects.csv in Shopify’s URL redirects page, then test a couple of old category addresses.
  4. Rebuild your store menu with the new collections.

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.

Run the free check See an example report

Other import errors

All Shopify import errors