Edge Images uses your edge transformation service (Cloudflare, Accelerated Domains, Bunny CDN, Imgix, or Imgproxy) to optimize the <img> markup already in your posts, templates, and media library. ⚠️ Important : You need a supported edge provider with image transformation enabled (Cloudflare Image R
PricingFree downloadThe WordPress.org download is free. Pro versions, add-ons or external services may cost extra.
CompatibilityRequires WordPress 6.4 and PHP 8.0.
SourceWordPress plugins · Nov 5, 2026
01 / Source details
Aboutthistool.
Edge Images uses your edge transformation service (Cloudflare, Accelerated Domains, Bunny CDN, Imgix, or Imgproxy) to optimize the <img> markup already in your posts, templates, and media library.
⚠️ Important : You need a supported edge provider with image transformation enabled (Cloudflare Image Resizing, Bunny CDN image processing, Imgix, Imgproxy, or Accelerated Domains). See the Requirements section for details.
🚀 Why should I use Edge Images?
Instant performance boost : Optimize and serve images in modern formats (WebP or AVIF, when your provider supports format=auto ) through the CDN you already use
Works with what you have : Existing images, existing themes, and the block editor. Select a provider and the markup is rewritten for you
No local processing by default : Transformations happen at the edge. Your server does not resize images, and it stores extra files only if you opt in
Right-sized images : srcset offers 1x, 1.5x, and 2x of the width the layout actually uses, and it never asks for a file larger than the original
Cost effective : Use the image transformation on your existing edge provider, instead of a separate optimization service or a stack of generated thumbnails
🎯 Perfect for
Sites with lots of images that need optimization
Performance-focused developers and site owners
Anyone using Cloudflare, Accelerated Domains, Bunny CDN, Imgix, or Imgproxy
Sites that want modern image formats without a local conversion pipeline
Developers tired of managing multiple image sizes
💡 How it works
WordPress typically creates multiple copies of each uploaded image in different sizes. That often means:
Images that are too large or too small for their display size
No modern format support (WebP/AVIF) unless you built a pipeline for it
Edge Images takes a different route:
01It rewrites image markup on the front end and in the block-editor canvas: attachments, content, excerpts, widgets, and local avatars
02It decides the layout width from the requested size, the width and height attributes, an inline width:Npx on the image or its figure, or the gallery column count
03It points src , srcset , and sizes at your edge provider, built from the full-size file
04The provider transforms the image on demand and caches the result
Picture wrapping and local copies stay off until you turn them on.
⚡️ Features
Core features
Automatic WebP/AVIF conversion when your provider honors format=auto
Layout-aware srcset at 1x, 1.5x, and 2x
Rewrites wp_get_attachment_image , content, excerpts, widgets, and local avatars
Optional <picture> wrapping, off by default, so existing layouts stay put
Original images stay on your server
Edge transformation by default, with no extra files until you ask for them
Advanced features
Transform arguments on an image: width, height, fit, quality, format, gravity, sharpen
Cloudflare, Accelerated Domains, Bunny CDN, Imgix, and Imgproxy
Developer-friendly filters and a small PHP helper
Yoast SEO and Rank Math, with a toggle for social, schema, and sitemap images
Block editor support
A settings status panel (inactive, needs attention, or active) and a settings link on the Plugins screen
Optional local copies of the transformed variants
🔌 Supported providers
Cloudflare with Image Resizing enabled. Select it and you are done. The transform domain is optional and defaults to the site URL.
Accelerated Domains with image transformation enabled. Selection is enough.
Bunny CDN with image processing enabled. Zone subdomain only, without .b-cdn.net .
Imgix with a configured source. Source subdomain only, without .imgix.net .
Imgproxy . The full base URL of your instance.
Choose None to stop rewriting without deactivating the plugin.
That is the layout width at 1x, 1.5x, and 2x, in a modern format when your provider can negotiate one, served from the edge, from the one original file. Candidates stop at the original file width, so nothing is upscaled. Lazy-loaded images get auto, in front of sizes when Edge Images writes that attribute. A multi-column gallery uses sizes="(max-width: 599px) 50vw, {100/columns}vw" .
The example above is Cloudflare. Bunny CDN, Imgix, Imgproxy, and Accelerated Domains get the same dimensions with their own URL shape.
Optional picture wrapping
Turn on “Wrap bare images in a picture element” and a bare image, including one from wp_get_attachment_image() , is wrapped:
An image that already sits in a <figure> keeps that figure. The figure gets edge-images-figure , and max-width , content-visibility , and contain-intrinsic-size stay on picture.edge-images-container , so captions and full-width alignments keep the figure’s own box. Galleries stay unwrapped. The layout stylesheet loads only while this option is on. If Picture Element Wrapping was already saved in an earlier version, that choice is kept.
Optional local copies
“Store transformed images locally under Uploads” is off by default. The first view still uses the edge URL and queues a job. About once a minute, a cron task fetches up to three jobs and saves the 1x, 1.5x, and 2x files under uploads. The next view serves those files. Editing or deleting the attachment removes them. Social, schema, and sitemap images stay on the edge.
On Cloudflare, local copies might reduce cost. Image Resizing is billed on unique transformations per month, so a stored variant is only requested once instead of counting again each month. Leave this off when your provider already caches transformed images cheaply.
🎨 Customization
Transform parameters
Control the transformation with attributes on the image, or arguments to the URL helper. Short and long names both work:
width / w and height / h : exact dimensions
fit : scale-down, contain, cover, crop, or pad. The default is cover
quality / q : compression level. The default is 85
Picture attributes can be passed as $attr['picture'] . They apply only while picture wrapping is enabled.
Filtering
// Disable all transformations. add_filter( 'edge_images_disable', '__return_true' ); // Skip one image. add_filter( 'edge_images_disable_transform', function( $disable, $html ) { if ( str_contains( $html, 'example.jpg' ) ) { return true; } return $disable; }, 10, 2 ); // Default quality. add_filter( 'edge_images_default_quality', function() { return 75; } ); edge_images_provider and `edge_images_domain` are also available. edge_images_max_width and `edge_images_width_multipliers` were removed in 6.0.0. `srcset` is 1x, 1.5x, and 2x of the layout width.
From PHP
Edge_Images\convert_src( $src, $size, $args = [] ); Edge_Images\Transformer::url( $src, $width, $height, $args = [], $dpr = 1.0 ); convert_src() resolves a registered size, or a width and height pair, and returns `Transformer::url()`.
🔧 Requirements
Essential
A supported edge provider with image transformation enabled: Cloudflare with Image Resizing enabled
Accelerated Domains with image transformation enabled
Bunny CDN with image processing enabled
Imgix with a configured source
Imgproxy with a reachable base URL
Technical
PHP 8.0 or higher
WordPress 6.4 or higher
✅ Getting started
05Install and activate the plugin
06Go to Settings → Edge Images
07Select your provider. Cloudflare and Accelerated Domains only need that selection. Bunny CDN, Imgix, and Imgproxy also need the subdomain or base URL
08Confirm the status panel reads Active
Your images are optimized on the next front-end view. Picture wrapping and local copies are there when you want them.
When Yoast SEO or Rank Math is active, the settings screen lists it as detected and enables the social, schema, and sitemap checkboxes. A missing plugin stays listed and its checkboxes stay inactive.
🤝 Integrations
Yoast SEO and Rank Math
When the matching plugin is active and its checkbox is on, social images, schema images, and XML sitemap images are rewritten at 1200×675 with fit=cover . Those URLs stay on the edge even when local copies are on.
🔒 Privacy
Edge Images processes images through your chosen edge provider. Here is what that means.
Data processing
Image URLs are passed to your chosen provider for transformation
The plugin does not collect personal data
Original images remain on your server. Only public URLs are processed
Imgproxy sends those URLs to the instance you configure, which may be your own server
Edge provider privacy
Cloudflare: Cloudflare’s privacy policy
Accelerated Domains: Servebolt’s privacy policy
Bunny CDN: Bunny’s privacy policy
Imgix: Imgix’s privacy policy
Data storage
Settings are stored in the WordPress options table
With local copies enabled, the plugin also stores the queue option edge_images_localize_queue , writes
02 / Source details
Gettingstarted.
01Upload the plugin files to /wp-content/plugins/edge-images/
02Activate the plugin through the Plugins screen in WordPress
03Go to Settings → Edge Images and select your provider
03 / Source details
Frequently asked questions.
Which edge providers are supported?
Cloudflare (Image Resizing), Accelerated Domains, Bunny CDN, Imgix, and Imgproxy.
Cloudflare and Accelerated Domains need only a selection. Bunny CDN, Imgix, and Imgproxy also need the subdomain or base URL on the settings screen. The status panel stays on “Needs attention” until that value is saved.
Do I need to generate different image sizes?
No. The edge provider resizes on demand from the full-size file. srcset offers 1x, 1.5x, and 2x of the layout width, and it never asks for a width larger than the original file.
Will this work with my existing images?
Yes. The plugin rewrites markup for images already in your media library.
Does this work with the block editor?
Yes. Markup is rewritten on the front end and in the block-editor canvas.
Does this wrap images in picture?
Only after you enable “Wrap bare images in a picture element” under Settings → Edge Images. It is off by default. Bare images are then wrapped, and an image that already sits in a figure gets a class on that figure instead. Galleries are left alone. The layout stylesheet loads only while the option is on. A saved Picture Element Wrapping choice from an earlier version is kept.
What about galleries?
Gallery images are rewritten with a column-based layout width and sizes="(max-width: 599px) 50vw, {100/columns}vw" . They are left unwrapped, so the core gallery layout keeps working.
Can I store copies locally?
Only after you enable “Store transformed images locally under Uploads”. The first page view still uses edge URLs and queues the variants. A cron task running about once a minute fetches them in batches of three. Reload after that job has run and the markup points at the files under uploads. Social, schema, and sitemap images stay on the edge.
On Cloudflare, local copies might reduce cost. Image Resizing is billed on unique transformations per month, so a stored variant is only requested once instead of counting again each month.
What do Yoast and Rank Math change?
When the matching plugin is active, and its checkbox is on, social, schema, and sitemap image URLs are rewritten at 1200×675. The settings screen shows each plugin as detected or not detected. Checkboxes for a plugin that is not installed stay inactive.
Are SVGs and avatars transformed?
SVGs and existing AVIF files keep their original URLs. Avatars that are files on this site are rewritten. Gravatar and other remote avatars are left alone. Avatars are not wrapped in <picture> and are not stored locally.
How can I report security bugs?
You can report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team help validate, triage, and handle any security vulnerabilities. Report a security vulnerability.
FinderPress Media Auditor helps site administrators scan for broken images, missing Media Library files, unreachable media URLs, and other media issues across WordPress content. Use it to audit images, video, audio, PDFs, featured images, and attachment files without sending scan data to an external
The Accepted Payment Methods plugin is a straightforward, lightweight solution that enhances your website by displaying visually appealing icons of the payment methods you accept. This plugin is ideal for a variety of websites, including e-commerce platforms, service-oriented websites, and informati
