Skip to content
WP PowerSuiteWP PowerSuite Docs

Quick navigation

Popular modules

Browse by category

Security19/19Login & UserssoonAdminsoonContentsoonMediasoonSEO & VisibilitysoonSpeedsoonSite Toolssoon
↑↓ navigate↵ openesc close154 guides · 154 modules

WebP Conversion

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

Section titled “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 an active license; conflicts with avif-conversion.

When to use it

Section titled “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

Section titled “When not to use it”

How to enable it

Section titled “How to enable it”
  1. Activate your WP PowerSuite license.
  2. Disable AVIF Conversion if it is on.
  3. Enable WebP Conversion under WP PowerSuite -> Modules -> Media.
  4. Confirm Server support is green, then set JPEG/PNG, WebP quality, Original files, and Exclusion suffix.
  5. Upload a test image and verify the Media Library entry is WebP.

How to test it

Section titled “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

Section titled “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.

FAQ

Section titled “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 is a Premium module and needs an active WP PowerSuite 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.

Section titled “Related modules”