Title: Blueprint Digital Image Optimizer
Author: BluePrint Digital LLC
Published: <strong>November 2, 2026</strong>
Last modified: November 2, 2026

---

Search plugins

![](https://ps.w.org/blueprint-digital-image-optimizer/assets/banner-772x250.png?
rev=3780710)

![](https://ps.w.org/blueprint-digital-image-optimizer/assets/icon.svg?rev=3780710)

# Blueprint Digital Image Optimizer

 By [BluePrint Digital LLC](https://profiles.wordpress.org/blueprintdev/)

[Download](https://downloads.wordpress.org/plugin/blueprint-digital-image-optimizer.1.5.2.zip)

 * [Details](https://wordpress.org/plugins/blueprint-digital-image-optimizer/#description)
 * [Reviews](https://wordpress.org/plugins/blueprint-digital-image-optimizer/#reviews)
 *  [Installation](https://wordpress.org/plugins/blueprint-digital-image-optimizer/#installation)
 * [Development](https://wordpress.org/plugins/blueprint-digital-image-optimizer/#developers)

 [Support](https://wordpress.org/support/plugin/blueprint-digital-image-optimizer/)

## Description

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.** A request for the old `.jpg` or `.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.

## Screenshots

[⌊Scan tab: server capabilities, library totals and the bulk run.⌉⌊Scan tab: server
capabilities, library totals and the bulk run.⌉[

Scan tab: server capabilities, library totals and the bulk run.

[⌊Image optimize tab: image-by-image status with Optimize now and Revert.⌉⌊Image
optimize tab: image-by-image status with Optimize now and Revert.⌉[

Image optimize tab: image-by-image status with Optimize now and Revert.

[⌊Settings: output format, quality, quarantine retention and redirects.⌉⌊Settings:
output format, quality, quarantine retention and redirects.⌉[

Settings: output format, quality, quarantine retention and redirects.

[⌊Media Library column showing the result of each conversion.⌉⌊Media Library column
showing the result of each conversion.⌉[

Media Library column showing the result of each conversion.

## Installation

 1. Upload the plugin folder to `/wp-content/plugins/` or install it from Plugins  
    Add New.
 2. Activate it. New uploads are converted from this moment on.
 3. Open Media  BP Image Optimizer. The Scan tab shows what the server supports and
    how many images are still in the old format.
 4. Run a dry run, then convert in batches. Keep the tab open while a run is in progress.

## FAQ

### Can I undo a conversion?

Bulk conversions, yes, for 30 days (the retention is a setting): Media Library  
Revert on the image, or `wp bpio revert <id>`. Upload-time conversions, no: the 
original is removed before the attachment exists, so keep your own copy of anything
you may need in its original format.

### Where are the originals kept?

In a folder under `wp-content/uploads/` with an unguessable name, protected by an`
index.php` and an `.htaccess`. After the retention window they are removed by a 
daily cron, or by `wp bpio trash --purge`.

### Why was an image left in the old format?

Because the WebP would not have been smaller without visibly degrading it. Those
images are marked “kept” and can be forced from the Image optimize tab.

### Does it work with other image optimizers?

Deactivate the other one first. Two plugins converting the same upload produce orphaned`.
webp` files by the thousand.

### Does the plugin phone home?

No. The plugin makes no request to any server other than your own site.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Blueprint Digital Image Optimizer” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ BluePrint Digital LLC ](https://profiles.wordpress.org/blueprintdev/)

[Translate “Blueprint Digital Image Optimizer” into your language.](https://translate.wordpress.org/projects/wp-plugins/blueprint-digital-image-optimizer)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/blueprint-digital-image-optimizer/),
check out the [SVN repository](https://plugins.svn.wordpress.org/blueprint-digital-image-optimizer/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/blueprint-digital-image-optimizer/)
by [RSS](https://plugins.trac.wordpress.org/log/blueprint-digital-image-optimizer/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.5.2

 * First directory review round: no shell command in this build (video is analysed
   in PHP and replaced from a file you compress yourself), the dismiss script of
   the notice is enqueued, time limits apply only to requests that encode, readme
   consistent about what can be undone.

#### 1.5.1

 * The heavy-video notice no longer promises a fix on servers that cannot re-encode
   video; it points to the list and the recipe instead.

#### 1.5.0

 * WordPress.org build: the quarantine stays inside wp-content/uploads, updates 
   come from the directory.
 * Escaping, sanitization and nonce annotations throughout the admin, as flagged
   by Plugin Check.

#### 1.4.1

 * Fixed: the quarantine record repair rewrote every record on hosts that expose
   the uploads directory under two names.

#### 1.4.0

 * Quarantine moved out of the web root on hosts that allow it; uploads are no longer
   quarantined.
 * Cache purge once per request, on bulk end and on single conversions.
 * Quarantine records corrupted by the reference rewrite are repaired automatically
   after upgrade.

#### 1.3.1

 * Files shared by two attachments are converted once and both attachments follow.

#### 1.3.0

 * Old image URLs answer a 301 to the converted file.

#### 1.2.0

 * Delivery layer for hand-written image tags; video preload control.

#### 1.1.0

 * Quarantine and revert.

#### 1.0.0

 * First release: convert on upload and in bulk, with verification.

## Meta

 *  Version **1.5.2**
 *  Last updated **8 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.1 or higher **
 *  Tested up to **7.1.4**
 *  PHP version ** 8.0 or higher **
 * Tags
 * [AVIF](https://wordpress.org/plugins/tags/avif/)[image optimization](https://wordpress.org/plugins/tags/image-optimization/)
   [images](https://wordpress.org/plugins/tags/images/)[performance](https://wordpress.org/plugins/tags/performance/)
   [webp](https://wordpress.org/plugins/tags/webp/)
 *  [Advanced View](https://wordpress.org/plugins/blueprint-digital-image-optimizer/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/blueprint-digital-image-optimizer/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/blueprint-digital-image-optimizer/reviews/)

## Contributors

 *   [ BluePrint Digital LLC ](https://profiles.wordpress.org/blueprintdev/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/blueprint-digital-image-optimizer/)