WordPress plugin

Safe WebP Queue

Convert WordPress Media Library images and generated sizes to WebP locally.

The plugin runs inside wp-admin, checks server support first, converts in small batches, keeps originals, and shows why each image converted, skipped, failed, or needs review.

It is built for cautious local WebP conversion: no cloud service, no database URL rewrites, no original-file replacement.

Version 0.1.3 Manual ZIP release GPLv2 or later Keeps originals GitHub source

Admin screen

Tools → Safe WebP Queue

Input

Media Library JPEG and PNG attachments with generated image sizes.

Output

Local sibling WebP files, status reasons, validation, cleanup, and CSV export.

Defaults

Originals stay in place. Frontend WebP serving is optional and off by default.

Useful for

Older WordPress Media Libraries with large JPEG/PNG files
Shared hosting where image conversion can fail silently
Cautious WebP conversion before performance cleanup
Seeing exactly which images converted, skipped, failed, or need review
Creating CSV evidence before deeper image/performance work

What it does

Local WebP conversion with conservative checks.

The queue checks server image support before conversion, works through small batches, stores uploads-relative metadata, and keeps a visible reason trail for each row.

GD and Imagick WebP support
Media Library JPEG/PNG attachments
Original files and generated image sizes
Uploads-relative WebP metadata
Stale or invalid generated WebP files
Risky files with clear skip reasons
Visible report CSV export
Plugin-generated WebP cleanup
Optional frontend WebP serving
Optional WebP generation for new uploads

Result table

Attachment rows, source counts, status, and reason.

Labels are operational. They show what converted, what was skipped, what failed, and what needs review.

CSV export includes

Attachment ID, title, file, source files, MIME type, dimensions, original size, estimated memory, WebP size, savings, editor, status, and reason.

Labels include Converted, Skipped, Failed, Needs review, and Eligible.

Data handling

Runs locally inside WordPress admin.

Checks and conversion run inside wp-admin. Results are shown for the current run and can be exported as CSV.

Safe WebP Queue does not call an IndexLane service, cloud optimizer, or external API for image conversion.

Limits

Not a database URL rewrite or cloud optimizer.

Safe WebP Queue does not delete original JPEG or PNG files.

It does not rewrite post content, replace database image URLs, call a cloud optimization service, convert GIF/SVG/AVIF files, process CSS background images, or replace every hardcoded image URL.

Frontend WebP serving is optional and off by default.

Original-file deletion Post-content rewrites Database image URL replacement Cloud optimization service GIF/SVG/AVIF conversion CSS background images Hardcoded image URL replacement

Release

Version 0.1.3 is available as a manual ZIP download.

Source code is available on GitHub.

Source on GitHub