Title: I-PR AVIF Converter – Automatic Image Optimization
Author: marcodigiacomantonio
Published: <strong>May 18, 2026</strong>
Last modified: May 18, 2026

---

Search plugins

![](https://ps.w.org/ipr-avif-converter/assets/banner-772x250.png?rev=3535303)

![](https://ps.w.org/ipr-avif-converter/assets/icon-256x256.png?rev=3535303)

# I-PR AVIF Converter – Automatic Image Optimization

 By [marcodigiacomantonio](https://profiles.wordpress.org/marcodigiacomantonio/)

[Download](https://downloads.wordpress.org/plugin/ipr-avif-converter.1.9.6.zip)

 * [Details](https://wordpress.org/plugins/ipr-avif-converter/#description)
 * [Reviews](https://wordpress.org/plugins/ipr-avif-converter/#reviews)
 *  [Installation](https://wordpress.org/plugins/ipr-avif-converter/#installation)
 * [Development](https://wordpress.org/plugins/ipr-avif-converter/#developers)

 [Support](https://wordpress.org/support/plugin/ipr-avif-converter/)

## Description

**I-PR AVIF Converter automatically converts your existing and new images to AVIF
format — the most efficient image format available today — without any cloud service,
subscription, or API key.**

After 1 month of production testing across 6 live sites (5,089 images, 2.2 GB saved),
this plugin achieves **40–70% file size reduction** with zero visible quality loss
and **0% conversion failure rate** on both Aruba and Serverplan shared hosting.

#### Real Production Results

 * dermopigmentazioneroma.it — 904 images, **721 MB saved (-68%)**, Mobile PageSpeed
   80/100
 * mangiaroma.com — 1,213 images, **804 MB saved (-70%)**, Desktop PageSpeed 97/
   100
 * artmerlino.it — 371 images, 167 MB saved (-64%)
 * apicolturalapegaia.it — 1,069 images, 135 MB saved (-69%)
 * fnahospitalityroma.it — 432 images, 83 MB saved (-43%)

**Total: 4,989 images converted. 0 failures. 2.2 GB saved.**

#### Why AVIF?

AVIF is the next-generation image format supported by all modern browsers (Chrome,
Firefox, Safari 16+, Edge). Compared to JPEG, it delivers 40–70% smaller files at
equivalent visual quality. Compared to WebP, it delivers 20–30% better compression.
Google PageSpeed Insights and Core Web Vitals (LCP) reward AVIF-optimized sites 
directly.

#### How It Works

When you upload an image, I-PR AVIF Converter queues it for background conversion
via WP-Cron. No page load is blocked. Once converted, images are served automatically
via the `<picture>` HTML element with a fallback to the original for older browsers:

    ```
    <picture>
      <source srcset="image.avif" type="image/avif">
      <img src="image.jpg" alt="...">
    </picture>
    ```

Your original files are never modified unless you explicitly enable “Delete Originals.”

#### Key Features

**Zero cloud dependency** — All conversion happens on your server using PHP’s native
Imagick or GD library. No API keys, no usage limits, no recurring costs.

**Works on shared hosting** — Tested and production-proven on Aruba Basic and Serverplan
Eco/Basic. The plugin auto-detects your server’s encoder (Imagick or GD) and falls
back gracefully.

**Adaptive batch processing (AIMD)** — The plugin learns your server’s speed using
an Exponentially Weighted Moving Average and automatically adjusts how many images
it processes per cron run. It never causes timeouts or OOM errors.

**Memory guard** — Before processing each image, the plugin estimates the required
RAM based on image dimensions and encoder type (3.5× for Imagick, 1.8× for GD). 
If RAM is insufficient, the image is deferred to the next batch. No PHP Fatal errors.

**Circuit Breaker for Imagick** — If Imagick fails 3 consecutive times, the plugin
automatically switches to GD and retries Imagick after 30 minutes. No manual intervention
required.

**Quarantine system** — Images that fail 3 conversion attempts are automatically
quarantined and excluded from future runs. You can review and retry quarantined 
images from the admin panel.

**Skip Patterns** — Exclude specific images or folders using wildcard patterns (
e.g., `logos/*.png`, `2024/03/*-banner.jpg`). Useful for images where conversion
is not desired.

**Bulk Scanner** — Convert your entire existing media library with a real-time progress
bar. The scanner is paginated and runs via AJAX without blocking the admin interface.

**Telemetry Dashboard** — Real-time dashboard showing conversion rate, average compression
ratio, fail rate, performance score, and a rolling chart of the last 200 conversion
events.

**CDN integration** — Automatic Cloudflare cache purge after each batch conversion,
so your CDN always serves the latest AVIF files.

**Elementor & lightbox support** — Gallery lightboxes (Elementor, Fancybox, WP native)
are rewritten to serve AVIF in the full-size view, not just thumbnails.

**Animated GIF preservation** — Animated GIFs are automatically detected (binary
frame-count parsing) and excluded from conversion. AVIF does not support animation;
the plugin never converts a GIF to a broken static file.

**CMYK image handling** — Images from professional photography workflows (JPEG with
CMYK color space) are automatically converted to sRGB before encoding to prevent
color inversion artifacts.

**Clean uninstall** — Removing the plugin deletes all database tables, options, 
transients, and the WP-Cron job. Zero ghost data left behind.

#### WooCommerce Compatibility

Tested on two active WooCommerce stores. Product images, gallery thumbnails, and
checkout images are all converted and served correctly.

#### Encoder Compatibility

The plugin requires at least one of:

 * **Imagick** ≥ 7.0.25 with libheif compiled with AV1 support
 * **PHP** ≥ 8.1 with GD + libavif (`imageavif()` function available)

The Settings page shows which encoders are available on your server and their current
status (including Circuit Breaker state).

#### PHP & WordPress Compatibility

Tested on PHP 7.4, 8.0, 8.1, 8.2, 8.3. Compatible with WordPress 5.8 through 6.7.
PHP 8.2+ deprecation warnings have been resolved.

### External Services

This plugin optionally communicates with the **Cloudflare API** (`api.cloudflare.
com`) to purge CDN cache after batch image conversion.

This feature is **disabled by default** and only activates if you explicitly enable“
Cloudflare CDN Integration” in the plugin settings and provide your own Cloudflare
Zone ID and API Token.

No data is sent to Cloudflare unless this feature is manually configured. The only
data transmitted are the public URLs of newly converted AVIF images, which Cloudflare
needs to purge from its cache.

 * Cloudflare service: https://www.cloudflare.com
 * Cloudflare Terms of Service: https://www.cloudflare.com/terms/
 * Cloudflare Privacy Policy: https://www.cloudflare.com/privacypolicy/

All image conversion is performed locally on your server. No images or personal 
data are ever sent to external services.

## Screenshots

 * [[
 * Main settings page — encoder status, quality, batch, skip patterns
 * [[
 * Telemetry dashboard — real-time conversion rate, compression chart, fail rate
 * [[
 * Performance Score panel — Core Web Vitals proxy metrics

## Installation

 1. Upload the `ipr-avif-converter` folder to `/wp-content/plugins/`
 2. Activate the plugin through the **Plugins** menu in WordPress
 3. Go to **Settings  I-PR AVIF Converter** to verify your server’s encoder support
 4. Upload a test image to verify conversion works
 5. Optionally: run the **Bulk Scanner** to convert your existing media library

**No API keys. No account registration. No configuration required beyond activation.**

#### Recommended Settings

For most shared hosting environments, the defaults work without changes:

 * Quality: 70 (recommended range: 65–75)
 * Batch size: 3 (auto-calibrated by AIMD — you can leave this at default)
 * Cron interval: 5 minutes

#### Verify Encoder Availability

Go to **Settings  I-PR AVIF Converter** and check the “Encoder Status” section. 
The plugin shows green/yellow/red status for Imagick and GD with a one-click probe.

If neither encoder is available, contact your hosting provider and ask them to enable
PHP Imagick with libheif or PHP 8.1+ with libavif.

## FAQ

### Will this plugin work on my shared hosting?

Very likely yes. The plugin has been tested in production on Aruba Basic and Serverplan
Eco/Basic — two of the most restrictive shared hosting environments used in Italy.
If your host offers PHP 7.4+ (or 8.1+) with either Imagick or GD, the plugin will
work.

### What happens if my server doesn’t support AVIF?

The plugin checks encoder availability at activation. If no AVIF encoder is found,
conversion is skipped and the original images are served unchanged. Your site will
not break.

### Does it slow down my site?

No. Conversion happens in the background via WP-Cron, completely asynchronously.
Frontend page loads are not affected during conversion. Once converted, AVIF files
are served statically — they’re just files on disk.

### Does it change my original images?

By default, no. Original JPEG/PNG files are preserved intact. The AVIF version is
a separate file stored alongside the original. If you enable “Delete Originals,”
originals are deleted after conversion — this option is marked as irreversible in
the UI.

### What browsers see the AVIF version?

Chrome 85+, Firefox 93+, Safari 16+, Edge 121+. For older browsers, the `<picture
>` element’s fallback `<img>` serves the original JPEG/PNG automatically. No JavaScript
required.

### Can I exclude specific images from conversion?

Yes. Use the **Skip Patterns** field in Settings. Supports wildcard matching (e.
g., `logo.png`, `logos/*`, `2024/01/*.png`). Patterns are matched against filename,
relative path, and absolute path.

### What happens if a conversion fails?

The plugin retries failed images up to 3 times. After 3 failures, the image is moved
to a **Quarantine List** and excluded from future runs. You can review, retry (“
pardon”), or clear quarantined images from the admin panel. Failed conversions never
block the rest of the queue.

### Is this compatible with WooCommerce?

Yes. Tested on two active WooCommerce stores. Product images, variable product galleries,
and checkout images all convert and serve correctly.

### What about Elementor galleries?

Yes. Version 1.9.2 added specific support for Elementor gallery lightboxes. Both
thumbnails and full-size lightbox images are served as AVIF.

### Does it support WebP?

Yes, optionally. WebP generation is disabled by default (AVIF supersedes it). If
you enable “Generate WebP also” in Settings, both formats are generated and the `
<picture>` element includes WebP as a fallback between AVIF and the original.

### Is there a limit on how many images can be processed?

No hard limit. The plugin has been tested with libraries of 1,200+ images. The bulk
scanner and queue are both designed for large libraries. The AIMD algorithm automatically
adjusts batch size to fit your server’s constraints.

### Will it affect my Core Web Vitals?

Yes, positively. Smaller images directly improve LCP (Largest Contentful Paint) 
scores. PageSpeed improvements of +5 to +15 points have been observed on production
sites.

### What data does the plugin store?

The plugin creates one database table (`wp_avif_conversions`) to store conversion
history for the dashboard stats. All other state is stored in WordPress options 
and transients. Everything is deleted cleanly on plugin removal.

### Is there a Pro version?

Not currently. The plugin is fully functional in its free version.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“I-PR AVIF Converter – Automatic Image Optimization” is open source software. The
following people have contributed to this plugin.

Contributors

 *   [ marcodigiacomantonio ](https://profiles.wordpress.org/marcodigiacomantonio/)

[Translate “I-PR AVIF Converter – Automatic Image Optimization” into your language.](https://translate.wordpress.org/projects/wp-plugins/ipr-avif-converter)

### Interested in development?

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

## Changelog

#### 1.9.6 – April 28, 2026

 * WordPress.org compliance: All internal prefixes renamed from `AVIF_` to `IPR_AVIF_`(
   classes, constants, options, hooks, transients)
 * WordPress.org compliance: Text domain updated to `ipr-avif-converter` across 
   all 174 instances
 * WordPress.org compliance: All option keys and hook names prefixed with `ipr_avif_`

#### 1.9.5 – April 21, 2026

 * WordPress.org compliance: Rebranded to “I-PR AVIF Converter” for distinctive 
   identity
 * WordPress.org compliance: Maintained slug `avif-converter` for compatibility
 * WordPress.org compliance: Fixed lock file storage — now creates dedicated `/uploads/
   avif-converter/` subdirectory
 * WordPress.org compliance: Added documentation clarifying DOM-based HTML escaping
   in output methods

#### 1.9.4

 * Added: Complete `uninstall.php` — removes all database tables, options, transients,
   and WP-Cron jobs on plugin removal. Zero ghost data.
 * Added: Clear UI warning for “Delete Originals” option (irreversible action)

#### 1.9.3

 * Fixed: PHP 8.2+ compatibility — removed deprecated `mb_convert_encoding()` with
   HTML-ENTITIES in DOMDocument handling. No functional changes, resolves deprecation
   warnings on PHP 8.2+.

#### 1.9.2

 * Fixed: Elementor gallery lightbox now serves AVIF for full-size images, not just
   thumbnails
 * Added: Support for Fancybox, WP native galleries, and generic `data-lightbox`
   attributes

#### 1.9.1

 * Fixed: Animated GIFs are now correctly preserved — binary frame-count detection
   prevents conversion to broken static AVIF

#### 1.9.0

 * Added: AIMD (Additive Increase Multiplicative Decrease) adaptive batch processing
 * Added: EWMA-based timing prediction with pre-flight batch size reduction
 * Added: Performance Score dashboard panel
 * Added: Core Web Vitals proxy metrics (CWV)
 * Added: Telemetry buffer (last 200 events with fail rate tracking)
 * Changed: Average compression ratio improved to 64–68%

#### 1.8.0

 * Added: Real-time telemetry dashboard with conversion charts
 * Added: CDN integration (Cloudflare automatic cache purge)
 * Added: Bulk scanner for existing media library
 * Added: Performance Score calculation

#### 1.0.0

 * Initial release
 * Automatic JPEG/PNG  AVIF conversion via WP-Cron
 * `<picture>` tag output with automatic browser fallback
 * Dual encoder support: Imagick and GD
 * Admin settings page with encoder status
 * Background queue processing

## Meta

 *  Version **1.9.6**
 *  Last updated **22 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [AVIF](https://wordpress.org/plugins/tags/avif/)[image optimization](https://wordpress.org/plugins/tags/image-optimization/)
   [Page Speed](https://wordpress.org/plugins/tags/page-speed/)[performance](https://wordpress.org/plugins/tags/performance/)
   [webp](https://wordpress.org/plugins/tags/webp/)
 *  [Advanced View](https://wordpress.org/plugins/ipr-avif-converter/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/ipr-avif-converter/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/ipr-avif-converter/reviews/)

## Contributors

 *   [ marcodigiacomantonio ](https://profiles.wordpress.org/marcodigiacomantonio/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/ipr-avif-converter/)