Fix
Licence screen and background checks
- Activating or deactivating a licence with a field missing from the form could write a PHP warning to the error log. It now shows the usual Please add all information message.
- Licence checks run from WP-CLI or a cron job could write a PHP warning about a missing remote address. They now run without it.
Fix
Translations
- Three Media Library messages shown after a bulk action (how many items were skipped, how many failed, and the first error) now carry notes for translators.
- The plugin ships an empty languages folder, matching its Domain Path header.
New
Meow Gallery and Meow Gallery Pro
- Images linked to their media file (Link to: Media File) open the CDN copy. Meow Gallery built that link from the server address, which no longer worked once the local copy was removed.
- The Gallery Manager lists offloaded images whose local copy was removed. Meow Gallery left them out of its image picker because their file was not on the server.
- Map layout (Pro): the GPS position of new uploads is read before the local copy is removed. Photos already in the bucket get theirs read from a temporary download, in the background, the first time a map shows them, so they appear on the map again.
New
Fonts Plugin and Fonts Plugin Pro
- Fonts you upload in Fonts Plugin load from where they are served now, following Serve fonts from your site. Fonts Plugin saves each file's address when you save a font, so a font saved while it was on the CDN kept loading from the CDN. The saved fonts are not changed.
New
Integrations tab
- Fonts Plugin is listed under Fonts, and Meow Gallery under a new Galleries section. Both show when their Pro version is active.
Fix
Deleting a second copy keeps your settings
- When an update was uploaded to a second folder, deleting the extra copy from the Plugins screen ran that copy's uninstall routine. It removed the settings, licence and offload records that the active copy still uses. They are now kept whenever another copy of WP Media Cloud is installed, whatever version the deleted copy is.
Fix
Health tab result on providers other than Bunny.net
- After every check passed, the Health tab still said Run checks to see status, because the Bunny-only Provider API check is skipped on other providers. It now says All systems healthy.
v1.2.4
was not relesed publicly Fix
The settings screen always loads the version you installed
- After an update, a browser, CDN or cache plugin could keep serving an older copy of the WP Media Cloud settings screen, so its cards and options did not match the version you installed.
- The settings screen's script and stylesheet addresses now include a fingerprint of each file, so any change gives them a new address that no cache has seen.
- If an older copy still loads, WP Media Cloud downloads both files again past every cache and reloads the page once. If the old copy is still there after that, a message above the page says what is likely serving it: a cache or optimisation plugin, a CDN or server cache, or a second copy of the plugin.
New
Warning for a second copy of the plugin
- The Plugins page and WP Media Cloud's own page show a notice when another copy of WP Media Cloud is installed in a different folder, for example
wp-media-cloud-1 left over from an earlier upload. The notice names the folder and version of each copy, so you can delete the one that should not be there.
Fix
Settings link on the Plugins page
- The Settings link under WP Media Cloud on the Plugins page was missing when the plugin folder had another name.
New
Migration in the setup wizard
- When a site has media offloaded by WP Offload Media, Media Cloud or Advanced Media Offloader, the setup wizard shows it on its first screen: which plugin, how many files, the bucket and the provider. Use these settings fills in the provider, bucket, region, endpoint, CDN address and access keys from that plugin's settings or its wp-config constants.
- The access keys never reach the browser. The wizard shows them as copied, and the server fills them in when you load buckets, test or save.
- The last step saves the settings and imports the records with a progress bar. No file is uploaded again or moved, and the wizard ends with the next steps.
- The old plugin no longer has to be active: its data is found after it was deactivated, in the wizard and on the Migration tab.
- Media Cloud settings are read from its constants, its older
ILAB_ constants and, in network mode, the network settings, including its Cloudflare R2 public URL and custom region. With WP Offload Media, new uploads keep its object prefix, wp-content/uploads by default. - On multisite, keys from
wp-config.php constants are shared by the whole network, so only a super admin can copy them into a subsite.
New
Serve fonts from your site
- A new switch in Settings > Offload Behaviour, on by default, keeps font files (
.woff2, .woff, .ttf, .otf, .eot) on your server and loads them from your own domain, never from the bucket or the CDN. Browsers block fonts from another domain unless it sends a CORS header, so fonts from your site always work. - Fonts in the Media Library are no longer offloaded, by any route: upload, Offload All Media, the background offload or WP-CLI.
- Fonts offloaded before are brought back automatically on the next admin page load. A font file missing on the server is downloaded from the bucket first, and the bucket copy is left alone.
- With Theme and plugin assets on, stylesheets still load from the CDN, but their fonts load from your site.
- Font files always keep their copy on your server: Remove local files and Remove Local Copies skip them.
New
Font plugins: Jooosi Fon and Nahnu Fonts
- Jooosi Fon (formerly Yabe Webfont): its font stylesheet and preload links are rebuilt whenever a font file moves to or from the bucket and when settings are saved, so they always point where the fonts are served. Its stylesheet is never copied as a theme asset.
- Nahnu Fonts, our own font plugin: its self-hosted fonts and stylesheet always load from your site and are never copied to the bucket.
- Both are listed under a new Fonts section on the Integrations tab.
New
Web Fonts check on the Health tab
- With Serve fonts from your site on, the check passes: no CORS rule is needed.
- With it off, the check uploads a small test font, loads it from your CDN as a browser would, and tells you whether fonts are allowed. Allow this site adds a CORS rule to the bucket only where it can work: Amazon S3, Cloudflare R2, DigitalOcean Spaces, Wasabi, Hetzner or Custom S3, when your access key may read the bucket's CORS rules and no Bunny.net pull zone sits in front. Otherwise the check says what to set in your provider's dashboard.
Fix
Font plugins on sites with ACPT
- With ACPT active, font plugins got the CDN address for the uploads folder on the front end, so their stylesheets could point at font files the bucket does not have. Jooosi Fon and Nahnu Fonts now always get your site's address; ACPT still gets the CDN.
Fix
Imported records and the current bucket
- Records imported from Advanced Media Offloader were labelled as Bunny.net, and Amazon S3 records from WP Offload Media and Media Cloud as Custom S3. Remove Local Copies, Clean Up Deleted Media and URL Replace then treated those files as in a different bucket and skipped them. Imports now keep the old plugin's provider. Records imported by earlier versions are corrected after the update and whenever you save settings, only when they are in the bucket WP Media Cloud is set up with and the old plugin used the same provider, so a bucket with the same name at another provider is never mixed up.
- Advanced Media Offloader imports ignored its
ADVMO_ constants in wp-config.php, so sites set up that way got records with no bucket. The import now reads the constants, keeps each record's region, and stops with a message instead of saving a record without a bucket.
Fix
Setup wizard on phones
- The storage provider choices in the setup wizard no longer run off the screen on a phone.
Fix
Google for WooCommerce and other plugins
- Fixed a fatal error ("Argument #2 ($post_id) must be of type int, string given") when another plugin asked WordPress for an image with an empty ID. Google for WooCommerce does this on Appearance > Customize when no site logo is set. Snippets that removed WP Media Cloud's image filters to work around it are no longer needed.
- Every WordPress and plugin hook WP Media Cloud uses now accepts arguments of an unexpected type, such as an empty string,
null or a numeric string, instead of stopping with a fatal error. Anything that is not a valid ID is handed back untouched, and valid IDs work as before. This covers media URLs, srcset, the media modal, uploads, deletes, the Media Library and its bulk actions, and the BuddyBoss, Enable Media Replace, EWWW, WPML, ACF and ACPT integrations.
Fix
Update WooCommerce Download URLs
- The tool has always written product files through WooCommerce itself, but a product's file list can still be damaged on save by another plugin. It now reads each product's file list back after saving and, if the saved list cannot be read or does not hold the new URL, puts the original row back byte for byte and reports it. Products whose stored file list is already damaged are skipped and counted, never saved over.
- The card now says the tool is optional: with Secure Downloads on, every download is signed when the customer clicks it, whether the product stores its local URL or its CDN URL.
New
Kadence theme and Kadence Blocks
- Kadence saves many image addresses as plain text, in places WordPress never passes through the usual image functions. WP Media Cloud now serves all of them from your CDN: Customizer backgrounds (site, header and footer rows, title bars), header, mobile and footer HTML, row, column and section backgrounds in Kadence Blocks CSS, Kadence headers, navigation and hooked elements, Kadence Conversions popups and Kadence Slider slides.
- Only files that are in your bucket are switched. Anything not offloaded yet keeps its local address, so nothing breaks while an offload is still running.
- Kadence has its own card under Integrations, in the renamed Page Builders and Themes section, showing which Kadence parts are active.
New
URL Replace, rebuilt (beta)
- Each file is now checked on its own. A URL is switched to the CDN only when WP Media Cloud has a record of the file in your current bucket, and by default the file is confirmed in the bucket first. Files that failed to offload, files added by FTP, protected store files and missing files keep their URL instead of becoming broken CDN links. Switching back to local works the same way and only happens when the local file exists.
- Finds every form a media URL is saved in: http, https and
//, with or without www, each plain, JSON-escaped (page builders) or URL-encoded. The form is kept when replacing. - Searches posts, custom fields, settings, term meta, term descriptions, comments and user profiles, and with Also search plugin tables every other table with your site's prefix, such as block CSS and form or slider data.
- Saved data that cannot be read safely (damaged serialized values, or values holding plugin objects) is left exactly as it is. Before, it fell back to a plain text replace that could corrupt it. A new value that would not fit its column is skipped instead of being cut short, and every value is read back after saving.
- The preview lists every linked file, whether it will be switched or why not, and where it is used, with links to edit each post. Media that is not offloaded yet can be offloaded from there first.
- Every changed value is saved before it changes, so a run can be undone. Undo never overwrites a value that was edited after the run.
- CDN URLs back to local also repairs links an earlier version of URL Replace pointed at the CDN for files that were never offloaded, whenever the file is still on your server.
- The one-post tool follows the same rules and can be undone too. New WP-CLI commands:
wp wpmc url-replace (with --dry-run, --all-tables, --to=local and --post) and wp wpmc url-replace-undo.
New
Remove Local Copies
- For media offloaded while Remove local files was off, for example during a migration, the new Remove Local Copies tool in Settings frees the server space in one go.
- Each file is checked in the bucket right before its server copy is deleted, and only removed when it is there with the same size. Protected store files, media in a different bucket and anything that cannot be confirmed are kept and listed with the reason.
- Also available as
wp wpmc remove-local, with --dry-run to count first.
Fix
WP-CLI tab
- The WP-CLI tab now lists every command, including
wp wpmc recount, rebuild-records, cleanup, remove-local, url-replace and url-replace-undo.
Fix
Secure downloads on Bunny.net: downloads pull zone
- Bunny Token Authentication protects every file in a pull zone, so turning it on for the pull zone that serves your images made those images stop loading. The new Downloads Pull Zone URL field in the WooCommerce and Easy Digital Downloads cards sends signed downloads through a second pull zone on the same storage zone, with Token Authentication on, while your images keep loading from the main one.
Fix
More media URLs served from the CDN
- Media URLs in page content saved with
http:// on an https site, with or without www, protocol-relative (//) or JSON-escaped by a page builder now load from your CDN too, for files that are in your bucket. Before, only the exact uploads URL was switched. - A media URL followed by a full stop, a shortcode bracket or an HTML entity such as
" could be read together with that text, and the file sent to the CDN even when it was never offloaded. URLs now end where the file name ends.
Fix
Remove local copies bulk action
- The Remove local copies bulk action in the Media Library now confirms every file, including each image size, in the bucket with the same size before deleting it. Before, it checked only the main file. Protected store files are skipped.
New
Automatic CDN purge on replace
- When an image optimizer re-uploads a compressed file, or you replace a file with Enable Media Replace, the old copies are now purged from your CDN automatically. Visitors get the new file without waiting for the cache to expire.
- Works with Bunny CDN, KeyCDN and CDN77. For a custom CDN, the new
wpmc_purge_urls action hands you the URLs so you can purge them yourself. - The new Auto purge CDN on replace switch in Offload Behaviour is on by default and can be turned off.
New
Download on demand
- When a plugin needs the local file of an offloaded image, such as the WordPress image editor or a thumbnail regenerator, the file is now fetched from your bucket automatically, used, and handled by your normal offload settings afterwards.
- Covers the image editor, cropping, WP-CLI, cron jobs and REST requests. Other AJAX actions can be added with the
wpmc_on_demand_ajax_actions filter. - The new Download on demand switch in Offload Behaviour is on by default.
New
Media Library bulk actions
- The Media Library list view now has three bulk actions: Offload to cloud, Download to server and Remove local copies. With Bunny Stream set up, a fourth, Send to Bunny Stream, appears too.
- Select up to 200 items at a time. After the action runs, a notice tells you how many were processed, skipped or failed.
New
Secure WooCommerce downloads for every provider
- Secure Downloads now works with every provider, not only Bunny.net. Downloadable product files are served through short-lived presigned URLs signed with your storage keys, so the bucket can stay private.
- No extra key is needed for S3-type providers. Bunny.net keeps using its Token Authentication Key.
- The Redirect only download method is now signed too. Before, only Force Downloads and X-Accel-Redirect were intercepted.
- Product files in WooCommerce's protected
woocommerce_uploads folder are only offloaded when Secure Downloads is on and your storage can keep them private: S3-type buckets get them without public access, Bunny.net needs a Token Authentication key, and on Cloudflare R2 and Backblaze B2 they stay on your server. Before, they were offloaded like any other file. - If a link cannot be signed, a protected product file is never handed out as a plain, permanent CDN address: it is served from your server, or the download is refused. Regular media that is already public on your CDN still downloads from its CDN address.
New
Easy Digital Downloads
- Offloaded EDD product files now download from the cloud, including with Remove local files on. Before, the Direct download method failed once the local copy was gone.
- EDD keeps product files in a protected
uploads/edd folder. Those files now stay on your server so they never land in a public bucket, unless you turn on Secure Downloads in the new Easy Digital Downloads card. - With Secure Downloads on, protected files are offloaded too and every download is a short-lived signed link: Bunny Token Authentication on Bunny.net, presigned URLs on every S3-type provider.
New
Bunny Stream video hosting (beta)
- The new Bunny Stream card sends Media Library videos to a Bunny Stream video library. New video uploads go to Stream automatically, and existing videos can be sent with the Send to Bunny Stream bulk action.
- Video blocks and [video] shortcodes for streamed videos render the Bunny player, so playback is adaptive (HLS) and served by the Bunny video CDN.
- Works with every storage provider: images can live on any bucket while videos live on Stream. The local file is kept, so turning Stream off falls back to the local video.
- With Delete from cloud when deleted in WP on, deleting the attachment deletes the Stream video too.
- Uploads to Stream run in the background, so uploading a large video never holds up the Media Library. An upload that gets interrupted continues into the same Stream video instead of creating a second one. If an upload to Stream fails, the video is offloaded to your bucket like any other file, and you can retry Stream later from the bulk action.
New
Nahnu Video for Bunny Stream
- WP Media Cloud now works hand in hand with Nahnu Video for Bunny Stream, our free plugin for showing Bunny Stream videos anywhere with
[bunny_video], [bunny_grid] and [bunny_playlist] shortcodes and blocks. - Videos WP Media Cloud sends to Stream appear in Nahnu Video right away, linked to their Media Library item, and streamed videos in your posts play with its player.
- Nahnu Video can use the Stream library ID and API key from WP Media Cloud, so you enter them once. A video's
[bunny_video] shortcode is shown on its Media Library screen, ready to copy. - Deleting a streamed video in WP Media Cloud removes it from Nahnu Video too.
New
Theme and plugin assets on the CDN (beta)
- The new Theme & Plugin Assets card can serve your enqueued CSS and JavaScript files from your bucket and CDN, next to your media.
- Fonts and images referenced inside CSS files are uploaded too, and the CSS is rewritten so those references point at the CDN.
- Files are re-uploaded under a fresh address when they change, so an updated theme or plugin never serves a stale copy.
- The optional Assets CDN URL serves assets from their own hostname, e.g. cdn.example.com while media stays on media.example.com. Both must point at the same bucket.
New
Path prefix and shared multisite buckets
- The new Path prefix field in Offload Behaviour stores all uploads under a folder of your choice inside the bucket.
- On multisite,
%site_id% in the prefix becomes the site ID, so every site can share one bucket with a prefix like sites/%site_id% while keeping its files separate. - Can also be set in code with the
WPMC_PATH_PREFIX constant.
New
FileBird, Real Media Library and HappyFiles
- Media folder plugins are now fully supported. Folders live in your database, so offloading, removing local copies and restoring never touch them, and the Media Library bulk actions work inside any folder view.
- The new
%folder% token in the path prefix mirrors your folder tree in the bucket: with a prefix of media/%folder%, a file in Products > Hero Shots offloads under media/products/hero-shots/. - The folder is read at offload time. Moving a file to another folder later does not move the stored object, and its URLs keep working.
New
Recover records from the bucket
- If the offload records are lost while the files are still in cloud storage, for example after a database restore, the new Recover Records from Bucket card on the Settings page rebuilds them. Media is then served from the cloud again without uploading anything twice.
- It checks a sample first and shows where the files were found, then looks for each attachment's files in the current bucket and recreates its record with every image size that is there.
- Files are found under the configured path prefix, at the bucket root, and under the
wp-content/uploads prefix other offload plugins use. Nothing is uploaded or deleted, and existing records are never changed. Also available as wp wpmc rebuild-records, with --dry-run to preview. - Thank you to Matt for contributing the tool this feature is based on.
New
Clean up deleted media
- Media deleted in WordPress while Delete from cloud when deleted in WP was off left its files in the bucket. The new Clean Up Deleted Media card on the Settings page scans for them, shows how many files and how much space they take with examples, and deletes them after you confirm.
- The scan works from the plugin's own offload records, so only files the plugin uploaded for media that no longer exists are removed. Anything else in the bucket is never touched.
- Files another attachment still uses, such as a media translation, are kept. Items offloaded to a different bucket than the current one are left alone and listed separately.
- A file the storage refuses to delete keeps its record, so the next cleanup can try again. Also available as
wp wpmc cleanup, with --dry-run to preview.
New
Storage stats for every provider
- The Storage Used stat on the Dashboard now shows a value for every provider, counted from the plugin's own offload records, whenever the provider's API does not report bucket usage.
- A background recount keeps the number accurate, and the new
wp wpmc recount WP-CLI command recounts on demand.
Fix
Safety and reliability
- Clean Up Deleted Media checks every file on its own. When a newer image reuses a deleted image's file name, its sizes and original are kept.
- Theme & Plugin Assets only copies static files (CSS, JavaScript, fonts and images). Stylesheets generated by PHP keep loading from your site, and a stylesheet whose fonts or images cannot be copied stays local.
@import and root-relative url(/...) references are handled, and switching provider, bucket or CDN URL starts the copies over. - Download on demand only runs for image edits by users who can upload, WP-CLI and cron, never for public media listings.
- A WooCommerce product file always resolves to exactly that file, never to a different one with a similar name. One rejected product no longer stops Update Download URLs.
- Storage Used counts the whole library once on sites updated from an earlier version, instead of showing only new uploads.
- On multisite networks where sites share one bucket without a path prefix, Clean Up Deleted Media and Recover Records from Bucket refuse to run and explain how to set
sites/%site_id%, since files could belong to either site. A main site without a prefix next to subsites using sites/%site_id% is fine. - Remove local copies keeps the server copy when the file cannot be found in the current bucket.
- CDN purges run in the background, and Enable Media Replace also purges the old address when the file name changes. The Reset All Settings dialog works with the keyboard.
Fix
Secure downloads on Bunny.net
- Signed download links on Bunny.net returned 403 when Token Authentication was turned on for the pull zone. The token was built in a format Bunny does not accept. Links now use Bunny's Token Authentication V2 format, for WooCommerce and Easy Digital Downloads.
- File names with spaces, accents or other special characters are signed correctly too.
Fix
WooCommerce download URLs
- With Secure Downloads on, product files that still use their local URL are now served from the cloud through a signed link. Older
http:// and www URLs and server paths are recognised too. Product URLs no longer need to point at the CDN, so this works with Rewrite URLs off. - Update Download URLs now runs in batches with progress, so it no longer times out on large stores. It recognises the same URL forms and reports why a file was left as it is: already on the CDN, not offloaded yet, not in the Media Library, or a link to another site.
Fix
Reset All Settings keeps your offload records
- Reset All Settings also deleted every offload record, although its confirmation only mentioned settings. The files stayed in the bucket, but the plugin no longer knew they were offloaded.
- A reset now keeps the records, so media loads from the cloud again as soon as you reconnect the same bucket. Clearing them is a separate, clearly labelled option in the confirmation, meant only for moving to a new bucket without copying files.
- If your records were cleared by an earlier reset, Recover Records from Bucket brings them back.
Fix
Re-uploads after an optimizer or media replace
- When a file was changed and uploaded again within the same request, for example an optimizer compressing an image right after its first offload, the upload could use the file's old size. It then stalled until it timed out and failed. Uploads now always read the current size.
- Attachments an integration keeps out of the bucket on purpose, such as Bunny Stream videos and protected EDD files, no longer show as failed on the Offload page or in bulk offload counts.
- When an optimizer re-upload lands under a different folder, the old copies are removed from the bucket. A size whose local file is already gone keeps its existing cloud copy, so it keeps loading.
Fix
CDN statistics
- KeyCDN bandwidth stats now load. The plugin was calling the KeyCDN reports API with the wrong date format, so the Dashboard chart stayed empty.
- CDN77 zone lists and traffic stats now load. The plugin now uses the current CDN77 v3 endpoints and reads the response correctly.
- Bunny.net dashboards without a connected storage zone no longer request
/storagezone/0, which returned an error. Bandwidth stats still load.
Fix
EWWW and Easy IO
- The EWWW Image Optimizer integration is now started correctly, so compressed files are re-uploaded when EWWW finishes. Before, the integration was never initialised.
- The Easy IO card on the Integrations page now reads the Easy IO status the same way EWWW itself does, so it no longer shows the wrong state on some sites.
Fix
URL Replace (beta)
- URL Replace now also finds URLs that only appear in a JSON-escaped form, such as page builder data where every slash is written as
\/. Those rows were skipped before.
Fix
Imported media in post content
- Media imported from another offload plugin that stored files under a
wp-content/uploads/ prefix in the bucket is now rewritten correctly inside post content, srcset attributes and the Media Library grid.
Fix
Integrations status
- WooCommerce and other plugins you just activated could show as not active on the Integrations tab for up to five minutes, and their Settings cards stayed hidden. The status now updates on the next page load after any plugin or theme change.
New
Health page upload test for every provider
- The Upload Test row on the Health page now uploads a small test file to your bucket and deletes it again for every provider, not only Bunny.net. It shows "Test file uploaded and deleted successfully." when your keys and bucket work.
- When the upload fails, the row shows "Test upload failed:" followed by the error from your provider, so you can see the cause straight away.
- If the upload works but the delete is refused, the row warns you and names the test file to remove.
New
Safer URL rewriting in post content
- Media URLs inside post content now point at your CDN only when that file is offloaded. Every image size is checked against the offload records.
- Files that are not offloaded yet keep their local URL, so images in older posts keep loading while a bulk offload runs.
- A URL whose local file no longer exists still points at the CDN, which covers files removed after offload and files imported from another offload plugin.
Fix
Licence
- Fixed an error that could stop a licence key from activating.
- Error messages on the License tab now show in red instead of green.
Fix
Bulk offload and migration
- When your host blocks loopback requests, the WP-Cron backup now uploads a batch itself every 5 minutes. Before, it only tried to restart the blocked request, so the bulk offload could stay stuck.
- The import from WP Offload Media, Media Cloud by ILAB and Advanced Media Offloader no longer loops forever when some attachments cannot be imported. It stops and tells you how many are left.
Fix
Deleting and restoring
- Delete from cloud when deleted in WP now keeps the cloud files when another attachment still uses them, such as a WPML or Polylang media translation. Only the deleted attachment's record is removed.
- Restore URLs in the Danger Zone card no longer corrupts serialized data in custom fields. Values are now unserialized, updated and saved again.
Fix
Image optimizers
- When the second upload after an optimizer finishes fails, the previous cloud record is kept, so the image keeps loading from the cloud.
- ShortPixel completion is now detected correctly, so the compressed file is uploaded again when ShortPixel finishes.
Fix
Settings and Health
- Choosing Direct Bucket in a CDN card now clears the old CDN URL, so media goes back to the bucket address.
- The Health page now finds the Cloudflare R2 secret key, so the storage check no longer reports it as missing.
- The readme example for Amazon S3 now uses the correct provider name,
aws.
New
Keys limited to one bucket work everywhere
- The setup wizard's Bucket name field can now be typed for DigitalOcean Spaces, Wasabi, Hetzner, Backblaze B2, Amazon S3 and Google Cloud Storage. Access keys limited to one bucket no longer need permission to list buckets.
- Load still lists your buckets when your keys allow it, and now shows the provider's error when they do not.
- Re-running the setup wizard opens with your saved values filled in for every provider, including region, bucket, CDN choice and CDN URL.
Fix
Fixes
- Fixed saving Settings clearing the CDN URL and CDN choice for Cloudflare R2, Hetzner, Backblaze B2, Google Cloud Storage, Amazon S3 and custom S3 endpoints. On Cloudflare R2 this stopped offloading until the CDN URL was entered again.
- Fixed saving Settings clearing saved pull zone, KeyCDN zone and CDN77 resource IDs, which removed bandwidth stats.
- The Health page and Dashboard stats now read settings defined in
wp-config.php. - Every CDN constant printed by the wp-config generator is now read by the plugin.
- The WooCommerce Secure Downloads switch now only appears for Bunny.net and Cloudflare R2, the providers that support signed links.
- Custom S3 now saves path style by default, matching what the wizard shows. Wasabi, Hetzner and Google Cloud Storage save their default region or location without re-selecting it.
- Settings now shows "Amazon S3" as the provider instead of "Bunny.net".
- The wizard's no-CDN option is now labelled Direct bucket URL for every provider.
v1.1.7.1
October 22, 2026 New
Run the setup wizard again
- New run the setup wizard link in Settings to change your bucket, keys or provider without resetting all settings.
- The wizard opens with your current values filled in. Saved keys show as Saved, so you only paste the ones you are changing. Offloaded files, records and other settings are kept.
- New optional
WPMC_R2_API_TOKEN constant for the read-only Cloudflare token, so sites configured in wp-config.php can show R2 storage stats.
Fix
Fixes
- Fixed the setup wizard turning off Offload on upload and Rewrite URLs when it finished, which left new uploads on the server and media served locally.
- Fixed R2 storage stats ignoring settings defined as
wp-config.php constants. - When no read-only R2 token is added, the Dashboard now says so instead of showing a Cloudflare error.
- Corrected the multisite guidance in the About tab and readme: give each subsite its own bucket. Sharing one bucket between subsites is not supported yet, because files with the same upload date and name would overwrite each other.
Fix
Upgrade notes
- If you set up WP Media Cloud with the setup wizard, open Settings and check that Offload on upload and Rewrite URLs are on. Save, then run a bulk offload to pick up anything uploaded while they were off.
New
Multisite support
- Each subsite now has its own offload queue, lock, progress and schedule, so bulk offload can run on several subsites at the same time without interfering.
- Network-wide activation creates the database tables on every subsite, and new subsites are set up automatically.
- New Network Admin page, WP Media Cloud: Network Overview. It lists every subsite with its provider, progress bar, failed count and status (running, stalled, idle or not configured), plus network totals.
- Each subsite is configured on its own, so different subsites can use different providers and buckets.
- Uninstalling the plugin now cleans up every subsite, including leftover settings and queue data.
New
WP-CLI for large and multisite libraries
wp wpmc offload --network offloads every subsite in one command. Use --sites=2,5,9 to choose subsites and --limit to cap the batch size.wp wpmc offload --retry-failed retries items that failed earlier.wp wpmc status --network shows progress for every subsite.wp wpmc failed lists failed items with the reason for each.- Restore and clear-records now page through records in small steps and free memory as they go, so they are safe on very large libraries.
- Subsites without a configured provider are skipped with a clear message, and an invalid site ID is reported instead of stopping the run.
New
Failed items, getting started and search
- Items that fail to upload are now recorded with the reason and time, and stay safely on your server.
- New Failed Items panel on the dashboard with Retry all and Clear. Retries run in small chunks so requests never time out.
- New getting-started card for sites with nothing offloaded yet.
- New search box on the Integrations page to find a provider or integration by name.
- The About tab has a new What's new card and six new Known Behaviors entries.
- The WP-CLI page documents the failed-items and multisite commands.
- Layout improvements for phone-width screens.
New
New minimum requirements
- WP Media Cloud now requires WordPress 7.1 and PHP 8.3 or newer.
- On older servers the plugin pauses itself and shows an admin notice instead of causing errors. Your media keeps loading from your own site until you upgrade.
- Removed compatibility code for older WordPress and PHP versions.
Fix
Security
- Saved storage and CDN keys are no longer included in the admin page source. Saved fields show Saved. Paste a new value to replace it. and the server fills in the real value when needed.
- Offloading a single item from the Media Library now requires permission to edit that item.
- Restoring files to the server can no longer write outside the uploads folder.
- The background worker's security token is now sent in the request body, so it no longer appears in server access logs.
- A malformed reply from EWWW's server can no longer cause code to run.
- Admin form input is now cleaned correctly, so keys containing quotes or backslashes are saved as typed.
Fix
Offload and statistics fixes
- Fixed bulk offload stopping before the first item on servers with an unlimited PHP memory limit (
memory_limit = -1). This affected single sites too. - Fixed every offloaded item being recorded as Bunny.net. Amazon S3, Google Cloud Storage, Backblaze B2 and Hetzner now save their real provider, bucket and region.
- Fixed dashboard statistics for Wasabi, Hetzner, Backblaze B2, Google Cloud Storage, Amazon S3, custom S3 and S3-compatible providers, which fell through to the Bunny.net code and could crash.
- Fixed the Update CDN URLs tool not updating anything.
- Fixed cached statistics not clearing on single-site installs.
- Fixed restoring media migrated from WP Offload Media or iLab placing files in a nested uploads folder.
Fix
URL Replace (beta) and setup fixes
- Fixed selected options causing an error that repeated every 5 minutes.
- Fixed settings stored as lists, such as theme options, being saved in a damaged format.
- Fixed about half of the stored values being skipped on large sites.
- URL Replace no longer rewrites URLs stored inside another plugin's custom PHP objects. Those values are left untouched. Posts, post meta, options and page builder data are still rewritten.
- Fixed the EWWW Easy IO setup writing to
wp-config.php in the wrong place or leaving the file half-written. Writes are now atomic. - Fixed uninstall not finding the correct
wp-config.php and leaving some settings behind. - Fixed React key warnings in the browser console on dashboard and settings pages.
- Replaced remaining emoji and typographic dashes in admin messages with plain text and icons.
Fix
Upgrade notes
- If a bulk offload is running when you update, restart it once. Queues from earlier versions were network-wide and are cleared on upgrade.
- On multisite, run
wp wpmc offload --network after configuring each subsite's provider.
New
Storage engine rebuilt for large libraries
- Uploads now stream from disk and downloads stream to disk. File size is no longer limited by PHP memory.
- Files over 64 MB are sent as multipart uploads on every S3-compatible provider.
- Every object is stored with a one-year
Cache-Control header so CDNs and browsers cache it properly. - Object ACL is now configurable per provider in Settings and via
WPMC_*_ACL constants. DigitalOcean, Wasabi and Hetzner send public-read by default; Amazon S3, Google Cloud Storage and Backblaze B2 send none. - Network errors, rate limits and provider 5xx responses are retried once automatically.
- Upload timeouts scale with file size.
- Error messages now include the provider's own error code and message, for example
SignatureDoesNotMatch or AccessControlListNotSupported. - Custom S3 endpoints accept plain
http:// URLs for local MinIO and similar setups. - Added Stockholm to the Bunny.net storage regions and six new DigitalOcean Spaces regions: London, Bangalore, Atlanta, Richmond, Kansas City and San Francisco 2.
Fix
Provider fixes
- Fixed Amazon S3 not being saved as the active provider, and missing CDN and origin URL handling for Amazon S3, Google Cloud Storage and custom S3 endpoints.
- Fixed DigitalOcean, Wasabi and Hetzner uploads being stored as private objects, which caused 403 errors from the CDN.
- Fixed the S3-compatible provider ignoring the configured endpoint, and virtual-hosted addressing omitting the bucket name.
- Fixed CDN settings for Amazon S3, Google Cloud Storage and custom S3 being saved under the DigitalOcean settings keys in the setup wizard.
- Fixed
WPMC_AWS_* and WPMC_GCS_* wp-config constants not being recognised. - Fixed Bunny.net uploads for filenames containing spaces or special characters.
Fix
Fixes and improvements
- Fixed a fatal error in the licensing SDK files that prevented the plugin from loading on some installs.
- Fixed garbled icon characters appearing on some systems. All remaining emoji in the admin interface have been replaced with SVG icons.
- The License tab now shows the plan name directly from SureCart, so plan renames are reflected automatically. Unrecognised activation limits are described accurately instead of falling back to Unlimited.
Fix
WordPress 7.1 compatibility
- WordPress 7.1 introduced client-side media processing on Chrome 137+. The browser now generates all image sub-sizes locally and uploads them in a separate step from the main file via the new sideload REST endpoint. WP Media Cloud now correctly offloads those sub-sizes when WordPress completes the finalize pass, preventing thumbnails from serving local URLs or returning 404 errors on sites using Chrome-based browsers.
- Sites on Firefox and Safari are unaffected — server-side processing runs as a single pass and continues to work as before.
- Tested up to WordPress 7.1.
New
URL Replace tool (beta)
- Added URL Replace tool to Media Cloud > Migration. Scans
wp_posts (post content and excerpt), wp_postmeta, and wp_options for local upload URLs and replaces them with your configured CDN URL in a single background operation. - Handles three URL encoding variants per value: plain string, JSON-escaped forward slashes (
https:\/\/), and rawurlencode form (https%3A%2F%2F). Covers all page builders and serialized postmeta correctly. - Per-post replace available for targeted fixes without running a site-wide operation.
- Full revert to local URLs at any time via the same tool interface.
- Safely skips rows containing
__PHP_Incomplete_Class objects and a protected list of core WordPress options to prevent accidental breakage. - Progress tracked in real time with processed row count and changed row count reported separately.
v1.1.3.3 First public release
June 2026 WP Media Cloud 1.1.3.3 is the first public release of the plugin. It has been in active use on client sites managed by Nahnu Media and this release makes it available for general use. Every feature below is fully functional in this release.
New
Storage providers
- Bunny Edge Storage -- native Bunny API integration. Regional storage zones, CDN URL rewriting, and WooCommerce signed downloads via token authentication.
- Cloudflare R2 -- zero egress storage with SigV4 signed URL support for WooCommerce secure downloads.
- Amazon S3 -- full S3 integration across all regions with IAM credential support.
- Wasabi -- flat-rate, zero-egress S3-compatible storage.
- DigitalOcean Spaces -- S3-compatible storage with built-in CDN.
- Hetzner Object Storage -- EU-based, GDPR-friendly S3-compatible storage.
- Backblaze B2 -- low-cost S3-compatible storage.
- Google Cloud Storage -- multi-region GCS bucket support.
- S3-compatible endpoint -- generic support for MinIO, OVHcloud, Scaleway, Vultr, Linode, and any S3-compatible provider.
New
CDN integrations
- Bunny CDN -- pull zone URL rewriting integrated with Bunny Edge Storage.
- Cloudflare CDN -- CDN URL rewriting for media served through Cloudflare.
- KeyCDN -- CDN URL rewriting for any public HTTP origin.
- EWWW Easy IO -- CDN layer integration for image optimisation pipeline delivery.
- CDN77 -- CDN URL rewriting for any public HTTP origin.
- Custom CDN URL -- configure any CDN or custom domain to rewrite media attachment URLs.
New
Image optimiser integrations
- ShortPixel -- compress and convert to WebP and AVIF before offloading. Free 100 credits per month.
- Imagify -- Smart Compression with lossy, lossless, and WebP conversion pipeline.
- Smush -- lossless and lossy compression. WebP and AVIF on Pro.
- EWWW Image Optimizer -- server-side optimisation with lazy load and format conversion.
- TinyPNG -- credit-based PNG and JPEG compression with WebP support.
- Cimo -- browser-side Canvas API compression with no server load. Safari not supported.
- Image Optimizer by Elementor -- server-side WebP and AVIF pipeline. Works on any WordPress site; Elementor not required.
New
Page builder integrations
- Bricks Builder -- images in Bricks layouts and templates served from cloud storage automatically.
- Elementor -- images in Elementor widgets, theme builder templates, and WooCommerce layouts served from cloud storage.
- Etch -- images in Etch-built pages served from cloud storage via WordPress media library URL rewriting.
- Beaver Builder -- images in Beaver Builder modules and saved templates served from cloud storage.
- Divi -- images in Divi sections, rows, modules, and Theme Builder layouts served from cloud storage.
- Breakdance -- images in Breakdance elements, global headers, footers, and post templates served from cloud storage.
- Oxygen Builder -- images in Oxygen components and templates served from cloud storage. Supports Oxygen Classic and Oxygen 6.
- WPBakery -- images in WPBakery rows, columns, and elements served from cloud storage.
New
Plugin integrations
- WooCommerce -- product images, gallery images, category images, and downloadable files offloaded. Signed secure downloads on Bunny Edge Storage (token auth) and Cloudflare R2 (SigV4).
- Advanced Custom Fields -- Image, File, and Gallery field types offloaded transparently via media library URL rewriting.
- Meta Box -- Image, File, Image List, Image Advanced, File List, and File Advanced field types offloaded.
- ACPT -- Image, Gallery, and File field types offloaded via media library URL rewriting.
- WPML -- shared WordPress media library across all language versions. All translations automatically receive cloud storage URLs.
- Polylang -- shared media library across language versions. Cloud URLs applied to all translations automatically. Works with free and Pro.
- TranslatePress -- shared media library across language versions. Cloud URLs applied to all translations. Works with free and all paid plans.
- BuddyBoss -- profile photos, cover images, group images, activity feed media, message attachments, and course images offloaded automatically.
- JetEngine -- Image, Media Gallery, and gallery fields inside Repeater fields offloaded. Works via Dynamic Image widgets and Dynamic Tags in Elementor, Bricks, Gutenberg, and Divi.
- Pods -- Image/File Upload and multiple file/image fields offloaded. Works on Custom Post Types, taxonomies, users, and Advanced Content Types.
New
Core media offloading
- Automatic offloading of all new media uploads to the configured cloud storage provider on upload.
- Bulk migration tool to offload the existing WordPress media library to cloud storage in the background with no item limits.
- Transparent URL rewriting for all WordPress attachment URLs including featured images, gallery images, post content images, and custom field images.
- Optional local file removal after successful offload to cloud storage.
- Mirror deletion -- files removed from cloud storage when deleted from the WordPress media library.
- Custom path prefix configuration for organising files within the storage bucket.
- File versioning with optional timestamp appended to bucket paths to prevent CDN caching issues.
- Beta URL Replace tool for rewriting existing media URLs in post content and postmeta to match the configured cloud storage URL structure.
- SureCart licensing integration for activation and licence management.