Skip to main content

WOOCOMMERCE PRODUCT CSV

Prepare a UTF-8 product CSV for WooCommerce

WooCommerce's built-in product importer expects a UTF-8 CSV with its product schema. Keep the header names, quote commas inside values, and check IDs, SKUs, attributes, and image URLs before importing a separate copy.

Published:

Updated:

Related tool: Convert encoding & format

Use UTF-8 and the WooCommerce product schema

WooCommerce's official product CSV documentation recommends UTF-8 and its built-in schema. The importer uses commas as separators, expects values containing commas to be escaped, and maps known headers such as SKU, price, attributes, and images.

  • Japanese or accented text is broken: convert the confirmed source encoding to UTF-8.
  • A category or attribute contains commas: preserve the field boundary with the documented quoting or escaping rule.
  • Products update unexpectedly: distinguish an existing id: value from a SKU before import.

Start from the official sample or an exported product CSV

WooCommerce recommends using an exported product file or the sample CSV as the starting schema. Do not rename headers because a spreadsheet label looks clearer; map custom metadata explicitly with the meta: prefix described in the documentation.

  • Confirm whether the file creates new products or updates existing products by ID or SKU.
  • Review boolean values, product status, taxonomy hierarchy, and image URLs before converting anything.
  • Keep the original export and a pre-import copy for rollback and comparison.

Convert and review the product export in LocaCSV

If the diagnosis finds inconsistent columns or unclosed quotes, stop and fix the source structure deliberately. Encoding conversion cannot repair a broken product schema.

  1. Open a copy of the WooCommerce export in LocaCSV's format conversion workspace.
  2. Select the source encoding that displays product names correctly and UTF-8 as the output encoding.
  3. Keep comma as the output delimiter unless the importer and file preview prove another delimiter is required.
  4. Review the output header, SKU or id: values, quoted descriptions, and row count before starting the WooCommerce import.

Verify products before committing the import

  • The output is UTF-8 and every row has the same columns as the WooCommerce schema.
  • Comma-containing categories, descriptions, and attributes stay in one field.
  • The local product count and the number of records in WooCommerce's preview match.
  • Import a small set first and confirm product status, prices, variations, and images before the full file.

Treat product mapping errors as a separate branch

A valid UTF-8 CSV can still fail because a header is not in the built-in schema, an image URL is inaccessible, a variation is missing a required value, or an ID/SKU points to the wrong product. Use WooCommerce's mapping preview and logs for those cases.

Hand WooCommerce a traceable product file

Keep the source, converted output, preview screenshot, and imported product count together so an update can be reversed or audited.

Official WooCommerce documentation

Limits and import formats can change. Use the official documentation below as the final check for your account and plan.