About this plugin
Blueprint Digital Image Optimizer is the media standard Blueprint Digital uses on the WordPress sites it builds. It converts, verifies, and keeps bulk conversions reversible. Three things set it apart from the rest of the category: every result is verified (size and PSNR) before the source is touched, bulk conversions can be undone for 30 days from the Media Library, and old image URLs keep answering with a 301.
On upload. Every JPEG, PNG or HEIC is downscaled to a sane maximum (2560 px by default), converted to WebP (or AVIF where the server supports it), verified, and only then is the source removed. Upload-time conversions are final: the attachment is created already in the modern format, so there is no original to go back to.
Keep your own copy if you need the source file.
In bulk. An existing library is converted in small batches from the admin, with a dry run first. Every reference in posts, post meta and options is rewritten to the new file.
The original is set aside in a quarantine folder for 30 days (configurable), and the Media Library shows a Revert link on each converted image while it is there. Nothing is deleted the moment it is converted.
Verified, not assumed. A conversion is kept only when the result is smaller and still looks like the source (PSNR check). JPEGs that a previous optimizer already compressed hard are left alone instead of being degraded.
Old URLs keep working. png path answers a 301 to the converted file.
Delivery. Hand-written <img> tags that point at an old file are served the converted one, and heavy videos are kept from preloading until someone presses play.
Video. The Video tab lists the heaviest videos, tells which ones lack a faststart index (they download almost entirely before the first frame), and gives a recipe for compressing them on your own machine; wp bpio video-replace swaps the file in with the same reversible quarantine. This plugin never runs ffmpeg on your server.
WP-CLI. wp bpio status, wp bpio optimize, wp bpio revert <id>, wp bpio trash, wp bpio video.
What it needs
- PHP 8.0 or newer with GD or Imagick that can write WebP ( wp bpio status tells you).
- Enough free disk space for the quarantine: for 30 days the site holds both the original and the converted file of everything converted in bulk.
What it does not do
- It does not call any external service. Conversion happens on your server.
- It does not run any shell command. Video is analysed in PHP and replaced only by a file you compressed yourself.