Skip to content

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

See the deals

What happens when you upload an image

Step by step: which uploads WebP Auto Convert converts, how files are named and resized, and what happens if conversion fails.

2 min read · Updated 5 November 2026

The order of events

  1. You upload a file. WordPress checks it and saves it to wp-content/uploads.
  2. Before WordPress creates the attachment and its thumbnails, the plugin checks the file type against Convert these source formats.
  3. If it matches, the image is opened with your server’s image library, scaled down if it is bigger than Max width or Max height, and saved as WebP at your Quality.
  4. The original is kept on disk (or deleted, if you turned on Delete the original file after conversion) and WordPress carries on with the WebP file: the attachment, the full size and every thumbnail are WebP.

Which uploads are converted

Anything that goes through WordPress’s normal upload handling: the Media Library, the block editor’s image and gallery blocks, the classic Add Media window, page builders that use the WordPress media window, and uploads through the REST API. Files fetched from a URL by WordPress’s “sideload” route are converted too — for example product images pulled in by the WooCommerce CSV importer (see this guide).

Images that reach the uploads folder without WordPress — copied by FTP, or written directly by a plugin that bypasses the upload functions — are not converted.

File names

The WebP keeps the original name with a new extension: team-photo.jpg becomes team-photo.webp. If a team-photo.webp already exists in that month’s folder, the new file is called team-photo-1.webp, then -2 and so on, so nothing is overwritten.

If conversion fails

If the image cannot be opened or the server cannot write WebP, the plugin steps aside: the upload finishes as a normal JPEG or PNG and no error is shown. That keeps uploads working on any server, but it also means a host without WebP support fails quietly. See Images are not converted to WebP.

Transparency and colour

WebP supports transparency, so PNG logos and icons keep their transparent background. Converting is lossy at the quality you choose, so a PNG becomes much smaller but is no longer pixel-perfect — keep originals if you need the exact PNG.

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