WooCommerce import errors it finds
- Sorry, you are not allowed to upload this file type.
- Invalid file type. The importer supports CSV and TXT file formats.
- The file is empty or using a different encoding than UTF-8, please try again with a new file.
- The uploaded file exceeds the upload_max_filesize directive in php.ini.
- A product with this SKU already exists.
- A product with this ID already exists.
- Invalid product type.
- Variation cannot be imported: Missing parent ID or parent does not exist yet.
- Variation cannot be imported: Parent product cannot be a product variation
- Invalid catalog visibility option.
- Invalid product tax status.
- Unable to use image
- Accents and special characters garbled after a WooCommerce CSV import
- WooCommerce CSV import: variations or attribute options not showing
- WooCommerce CSV import: wrong prices, or products out of stock
- WooCommerce CSV import: columns show "Do not import" on the mapping screen
Also checked
- Rows whose cell count does not match the header, and quotes that never close.
- A leading apostrophe before = + - or @ in names, descriptions, categories and images, which WooCommerce keeps.
- Prices with currency symbols, which WooCommerce strips.
Not checked
- SKUs and IDs already in your store (only repeats inside the file).
- Whether each image link actually downloads (WooCommerce reports a failed download as "Error getting remote image").
- Your server's upload size limit and import time limit.
- Plugin columns, and whether a plugin product type (such as bundle) exists on your store; those show as a warning.
Questions
- What does the checker look at?
- The file type, encoding and header row, and every row: product types, SKUs and IDs, variations and their parents, attributes, visibility, tax status, published status, stock, backorders, prices and image values. Each rule comes from WooCommerce's own import code, and the sources are listed below.
- If the check passes, will the import work?
- It removes the problems that can be seen in the file. WooCommerce can still skip rows because of products already in your store (for example a SKU that is already used), images that fail to download, or your server's upload limit. Import a few products first.
- Was this tested on a live WooCommerce store?
- The rules were read from WooCommerce 11.2.2's import code, not tested on a live store. Where the code does not make the result certain, the checker says so next to the problem.
- Is my file uploaded anywhere?
- No. The page reads the file with your browser and converts it there. The only thing the site records is an anonymous count: which converter was used, a rough row count, and whether it worked. The privacy page lists every field.
Moving from another platform? Convert your product export to WooCommerce first.
Sources
- WooCommerce 11.2.2 source: CSVUploadHelper.php: https://github.com/woocommerce/woocommerce/blob/11.2.2/plugins/woocommerce/src/Internal/Admin/ImportExport/CSVUploadHelper.php
- WordPress source: wp-admin/includes/file.php: https://github.com/WordPress/wordpress-develop/blob/trunk/src/wp-admin/includes/file.php
- WooCommerce 11.2.2 source: class-wc-product-csv-importer-controller.php: https://github.com/woocommerce/woocommerce/blob/11.2.2/plugins/woocommerce/includes/admin/importers/class-wc-product-csv-importer-controller.php
- WooCommerce 11.2.2 source: class-wc-product-csv-importer.php: https://github.com/woocommerce/woocommerce/blob/11.2.2/plugins/woocommerce/includes/import/class-wc-product-csv-importer.php
- WooCommerce: Product CSV Importer and Exporter: https://woocommerce.com/document/product-csv-importer-exporter/
- WooCommerce 11.2.2 source: abstract-wc-product-importer.php: https://github.com/woocommerce/woocommerce/blob/11.2.2/plugins/woocommerce/includes/import/abstract-wc-product-importer.php
- WooCommerce 11.2.2 source: abstract-wc-product.php: https://github.com/woocommerce/woocommerce/blob/11.2.2/plugins/woocommerce/includes/abstracts/abstract-wc-product.php
- WooCommerce 11.2.2 source: wc-formatting-functions.php: https://github.com/woocommerce/woocommerce/blob/11.2.2/plugins/woocommerce/includes/wc-formatting-functions.php