WebP Conversion

Summarize with AI

WebP Conversion turns new JPEG and PNG uploads into WebP for smaller files and faster pages. It cannot run together with AVIF Conversion.

What it does

Converts uploads on wp_generate_attachment_metadata when Convert JPEG files and/or Convert PNG files are enabled (PNG keeps transparency).
WebP quality from 60-100 (default 80).
Original files: Delete original (save space) or Keep original as backup (FTP/File Manager only) in an originals subfolder.
Exclusion suffix (default -wpps) skips files whose basename ends with that suffix.
Ensures image/webp is in upload mimes; shows a Server support notice (GD imagewebp or ImageMagick WEBP).
Restore JPEG/PNG originals batch tool when backups exist.
Requires WP PowerSuite Pro; conflicts with avif-conversion.

When to use it

Enable it if:

You want automatic WebP for new media without a separate CDN optimizer.
Hosting supports GD WebP or ImageMagick WEBP.
You are not already using AVIF Conversion in WP PowerSuite.

When not to use it

How to enable it

Activate your WP PowerSuite license.
Disable AVIF Conversion if it is on.
Enable WebP Conversion under WP PowerSuite -> Modules -> Media.
Confirm Server support is green, then set JPEG/PNG, WebP quality, Original files, and Exclusion suffix.
Upload a test image and verify the Media Library entry is WebP.

How to test it

Upload a JPEG with conversion on and Delete original selected.
✅ Pass: Media Library shows .webp; FTP folder has no matching .jpg.
Upload photo-wpps.jpg with default exclusion suffix.
✅ Pass: file stays JPEG.
With Keep original, use Restore now after converting.
✅ Pass: JPEG/PNG restored from originals and library WebP removed.
❌ Fail: check Server support and license; confirm JPEG/PNG toggles are on.

Troubleshooting

Server support error. Enable GD WebP or ImageMagick WEBP on the host, or turn the module off.
Nothing converts. License inactive, both convert toggles off, or file matches Exclusion suffix.
Cannot enable with AVIF. Turn off AVIF Conversion first.

Manage with WP-CLI

Prefer the command line? You can turn this module on or off with WP-CLI instead of the dashboard:

# Turn the module on
wp powersuite module enable webp-conversion

# Turn the module off
wp powersuite module disable webp-conversion

# Check whether it is on, its category, and where its settings live
wp powersuite module get webp-conversion

Managing more than one site? Add --url=https://example.com to point a command at one site. If this is a Pro module, install WP PowerSuite Pro and activate your license first. New to WP-CLI? See the full command guide.

FAQ

What does WebP Conversion do?

It converts uploaded JPEG and/or PNG files to WebP during attachment metadata generation when the server supports WebP.

Is WebP Conversion free?

No. It ships in the WP PowerSuite Pro add-on. Install Pro beside the free plugin and activate your license.

Can I use it with AVIF Conversion?

No. WebP Conversion conflicts with AVIF Conversion - enable only one.

How do I skip a file?

Name the file so the basename ends with the Exclusion suffix (default -wpps), for example photo-wpps.jpg.

How do I turn WebP Conversion off?

Go to WP PowerSuite -> Modules, find WebP Conversion, and toggle it off.

Developer notes (hooks & filters)

Source: modules/webp-conversion/module.php. Boot: admin · context: admin, rest, ajax.

Filters: wp_generate_attachment_metadata, upload_mimes, wp_powersuite_skip_webp_conversion, wp_powersuite_webp_metadata_priority, wp_powersuite_webp_max_pixels. AJAX: wp_powersuite_webp_restore_batch.