Skip to content

Black Friday 50% off your first year on all premium plugins and the Suite.

See the deals

WebP for CSV-imported products

Import products from a CSV and have every product image downloaded from a URL arrive as a resized WebP — plus how to pre-convert images yourself.

2 min read · Updated 14 November 2026

When you import products with WooCommerce’s built-in CSV importer (Products → Import), the Images column can contain image URLs. WooCommerce downloads each one and adds it to the Media Library. Supplier and marketplace images are often huge JPEGs, so a big import can add gigabytes of oversized files in one go.

How the importer handles images

  • A value with :// is treated as a URL: WooCommerce downloads it, stores it through WordPress’s sideload process and attaches it to the product.
  • It remembers the source URL on the attachment, so re-importing the same CSV reuses the existing image instead of downloading it again.
  • A value without :// is treated as a file name already in your Media Library and nothing is downloaded.

WooCommerce itself does not convert the format; you get whatever the URL serves.

Option 1: convert during the import

Because the importer uses WordPress’s sideload process, WebP Auto Convert converts each downloaded image before WooCommerce creates the product gallery and thumbnails.

  1. Install and activate WebP Auto Convert (no licence key needed).
  2. In Settings → WebP Auto Convert, set Max width and Max height to the largest size your product pages and zoom use — 1600 or 2000 is plenty for most shops.
  3. Keep JPEG and PNG ticked and the quality around 80–85.
  4. Import a CSV with two or three products first and check the product images in the Media Library end in .webp.
  5. Run the full import.

Already imported? Products that were imported before you set this up keep their JPEGs. Re-running the same CSV does not replace them, because WooCommerce reuses images it has seen before.

Option 2: convert before the import

If you control the images, convert them on your computer (for example with Squoosh, ImageMagick or a batch export from your photo editor), upload them to the Media Library or a server, and put the .webp URLs or file names in the CSV. This works without any plugin, but it is an extra step every time the supplier sends new photos.

Speed tips for big imports

  • Resizing and converting take a moment per image; very large source images make the importer’s batches slower. If an import stalls, split the CSV into smaller files.
  • Make sure your server has enough PHP memory for the largest source image.
  • Run big imports outside busy hours on a live shop.

Frequently asked questions

Does the WooCommerce CSV importer support WebP images?

Yes, as long as WordPress on your server can process WebP. You can point the Images column at .webp URLs, or import JPEG URLs and let WebP Auto Convert convert them on arrival.

Will the gallery thumbnails be WebP too?

Yes. The download is converted before WordPress generates the product thumbnails, so every size WooCommerce uses is WebP.

Does this work with the WooCommerce REST API?

Yes. Images added by URL through the products REST API use the same download route as the CSV importer, so they are converted the same way.

Did this answer the question? No — open a support request