Woo to Shopify Check

Shopify import error · from WooCommerce

WooCommerce shortcodes and SEO variables showing in Shopify after import

Shopify product pages show text like [gallery ids="12,15"] or [contact-form-7 id="5"], the short description is gone, or SEO titles read %%title%% %%sep%% %%sitename%%.

Why it happens

WooCommerce descriptions are WordPress content: HTML plus shortcodes, which plugins expand into galleries, tabs, buttons and forms when the page is shown. Shopify keeps the HTML, since its Description column accepts it, but has nothing to expand shortcodes with, so they show as literal text. WooCommerce also has a separate short description, shown next to the price, which has no column in Shopify.

SEO plugins such as Yoast and Rank Math store titles and descriptions as templates with variables (%%title%%, %sitename%) that only the plugin understands. Copied as they are, they become the literal SEO title shown in search results.

How the free check finds it

The check keeps the description HTML, puts the short description on top of it when it is not already part of it, and flags every description that contains a shortcode. Yoast and Rank Math titles and descriptions are carried over when they are plain text; when they contain plugin variables they are left empty so Shopify falls back to its default, and the product is listed. Titles longer than Shopify’s 255 characters and products with no name are flagged as errors.

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

  1. Changes silently

    WordPress shortcode in the description

    Shopify shows shortcodes such as [gallery] as plain text on the product page.

    What to do: Replace the shortcode with its HTML before going live.

  2. Good to know

    SEO field with plugin variables

    Shopify does not understand variables like %%title%%; the field is left empty so Shopify uses its default.

    What to do: Write the SEO title and description in Shopify if you need them.

  3. Must fix

    Title over 255 characters

    Shopify cuts titles at 255 characters.

    What to do: Shorten the title.

  4. Must fix

    Product without a name

    Shopify requires a title; the product is imported as Draft with a placeholder name.

    What to do: Name it before publishing.

Fix it by hand

  1. For each flagged product, replace the shortcode with the HTML it produced: open the product on the live WooCommerce site, copy what it shows, and simplify it.
  2. Write SEO titles and descriptions in Shopify for your best-selling products first.
  3. Read the opening lines of a few descriptions on a phone: the short description now opens the text.

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