Adds presets for Amazon S3, DigitalOcean Spaces, Backblaze B2, and Wasabi; real-time Media Library live status badges, meta box, and bulk actions; multipart uploads for large files; and major background queue stability and performance improvements. Recommended for all users.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3685275,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3685275,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3685275,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3685275,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{"blueprint.json":{"filename":"blueprint.json","revision":3704072,"resolution":false,"location":"assets","locale":"","contents":"{\"$schema\":\"https:\\\/\\\/playground.wordpress.net\\\/blueprint-schema.json\",\"landingPage\":\"\\\/wp-admin\\\/admin.php?page=omnioffloader\",\"plugins\":[\"omnioffloader\"],\"login\":true,\"features\":{\"networking\":true},\"preferredVersions\":{\"php\":\"8.1\",\"wp\":\"latest\"},\"steps\":[{\"step\":\"setSiteOptions\",\"options\":{\"blogname\":\"Testing OmniOffloader\"}},{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"omnioffloader\"},\"options\":{\"activate\":true}}]}"}},"all_blocks":[],"tagged_versions":["0.1.0","0.1.1"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[3863,10725,233,46891,217],"plugin_category":[50,59],"plugin_contributors":[221881],"plugin_business_model":[],"class_list":["post-356907","plugin","type-plugin","status-publish","hentry","plugin_tags-cdn","plugin_tags-cloud-storage","plugin_tags-media-library","plugin_tags-offload","plugin_tags-s3","plugin_category-media","plugin_category-utilities-and-tools","plugin_contributors-huzaifaalmesbah","plugin_committers-huzaifaalmesbah"],"banners":{"banner":"https:\/\/ps.w.org\/omnioffloader\/assets\/banner-772x250.png?rev=3685275","banner_2x":"https:\/\/ps.w.org\/omnioffloader\/assets\/banner-1544x500.png?rev=3685275","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/omnioffloader\/assets\/icon-128x128.png?rev=3685275","icon_2x":"https:\/\/ps.w.org\/omnioffloader\/assets\/icon-256x256.png?rev=3685275","generated":false},"screenshots":[],"raw_content":"\n
Your media library is probably the biggest thing on your server. OmniOffloader moves it to cloud object storage, serves it from your own domain or CDN, and frees the disk space it was using \u2014 without changing a single URL in your content.<\/p>\n\n
Every upload is copied to the cloud automatically: the original, every generated thumbnail, scaled versions, and modern WebP\/AVIF sources. Image URLs and And because offloading should never be a one-way door, Bring Back<\/strong> downloads everything from the cloud to your server again \u2014 one file or the whole library \u2014 and hands your URLs back to local paths.<\/p>\n\n Bulk jobs are built for a small shared plan as much as a dedicated server. Work is processed in the background, large files are uploaded in parts, transfers that a host cuts short are reported and skipped instead of retried forever, and a misconfigured connection stops the run early with an explanation rather than grinding through your whole library.<\/p>\n\n This plugin bundles the AWS SDK for PHP (Apache-2.0), which is GPL-compatible under GPLv3 \u2014 covered by this plugin's \"GPL-2.0-or-later\" license.<\/p>\n\n\n Amazon S3, Cloudflare R2, DigitalOcean Spaces, Backblaze B2 and Wasabi each have a dedicated setup preset. Anything else that speaks the S3 API \u2014 MinIO, Storj, Linode Object Storage, Scaleway and so on \u2014 works through the generic S3-Compatible option, where you supply the endpoint and region yourself.<\/p><\/dd>\n No. URLs are rewritten as pages render, so your posts, pages, featured images and responsive Yes \u2014 that is what Bring Back<\/strong> is for. It downloads your media from the cloud to its original paths on your server, verifies every file arrived, and then stops rewriting URLs so everything serves locally again. You can restore a single attachment or the entire library.<\/p><\/dd>\n That depends on the retention policy you used. With Retain Local Files<\/strong>, every file is still on your server and nothing changes. With Smart Local Cleanup<\/strong> or Full Cloud Migration<\/strong>, some or all local files were deleted after being uploaded, so URLs would point at files that are no longer on disk. Run Bring Back before deactivating<\/strong> if you used either cleanup policy.<\/p><\/dd>\n No. The default policy, Retain Local Files<\/strong>, deletes nothing \u2014 the cloud simply becomes a second copy. Choose Smart Local Cleanup<\/strong> to delete only generated thumbnails while keeping every original, or Full Cloud Migration<\/strong> to reclaim the most space. Local files are only ever removed after the upload has been verified in your bucket.<\/p><\/dd>\n Most storage buckets do not serve files publicly over HTTP by default, and Cloudflare R2 has no public URL at all until you connect one. Pointing a custom domain or CDN hostname at your bucket is what makes your media publicly reachable \u2014 and it is what lets the files be cached at the edge.<\/p><\/dd>\n Yes. Define them as constants in Files are uploaded one at a time, so budget roughly one to four seconds per attachment depending on file size and your server's upload speed. Jobs run in the background and keep going after you close the tab. On hosts that block internal loopback requests, the admin screen drives the job instead \u2014 there, leave the Offload page open until it finishes.<\/p><\/dd>\n Yes:<\/p>\n\n Every write command supports Files above 64 MB are uploaded in parts, so a dropped connection costs one chunk rather than the whole transfer, and files larger than 5 GB are supported. If a transfer is still cut short by your host's time limit, that attachment is reported with an explanation and the job continues instead of getting stuck on it.<\/p><\/dd>\n The plugin activates and runs per site. It has not been through a dedicated multisite test pass yet, so treat multisite as unverified for now.<\/p><\/dd>\n\n<\/dl>\n\n\n New Features & Enhancements<\/strong><\/p>\n\n Reliability & Fixes<\/strong><\/p>\n\n Performance & Optimizations<\/strong><\/p>\n\nsrcset<\/code> attributes are rewritten on the fly, so your posts, pages and page builders keep working exactly as before.<\/p>\n\nSupported cloud storage providers<\/h4>\n\n
\n
Key features<\/h4>\n\n
\n
-scaled<\/code> originals and WebP\/AVIF sources.<\/li>\nWorks on any host, at any library size<\/h4>\n\n
Why offload media to cloud storage?<\/h4>\n\n
\n
Licensing note<\/h4>\n\n
\n
omnioffloader<\/code> folder to \/wp-content\/plugins\/<\/code>, or install it from the WordPress Plugins screen.<\/li>\n\n
Which cloud storage providers are supported?<\/h3><\/dt>\n
How do I configure Cloudflare R2?<\/h3><\/dt>\n
\n
https:\/\/media.yourdomain.com<\/code>) or enable the r2.dev<\/code> public access subdomain so your files can be served publicly.<\/li>\nHow do I configure Backblaze B2?<\/h3><\/dt>\n
\n
https:\/\/s3.us-east-005.backblazeb2.com<\/code>) and Region (e.g., us-east-005<\/code>) from the bucket details.<\/li>\nkeyID<\/code> and applicationKey<\/code>.<\/li>\nHow do I configure Amazon S3?<\/h3><\/dt>\n
\n
AmazonS3FullAccess<\/code> or a scoped bucket policy). Create and copy the Access Key ID and Secret Access Key.<\/li>\ns3:GetObject<\/code> permission to *<\/code>, or connect an Amazon CloudFront<\/strong> distribution pointing to your S3 bucket.<\/li>\nus-east-1<\/code>), Bucket Name, and your CloudFront\/CDN URL (or leave blank to serve directly from AWS).<\/li>\n<\/ol><\/dd>\nHow do I configure Storj (or other S3-compatible storage)?<\/h3><\/dt>\n
\n
https:\/\/link.storjshare.io\/s\/<KEY>\/<BUCKET><\/code>). Replace \/s\/<\/code> with \/raw\/<\/code> (e.g., https:\/\/link.storjshare.io\/raw\/<KEY>\/<BUCKET><\/code>).<\/li>\nhttps:\/\/gateway.storjshare.io<\/code> (or https:\/\/gateway.ap1.storjshare.io<\/code>), Region to us-east-1<\/code>, check Use Path-Style Endpoint<\/strong>, enter your Access Key, Secret Key, Bucket Name, and paste your https:\/\/link.storjshare.io\/raw\/...<\/code> URL in Custom Domain \/ CDN URL<\/strong>.<\/li>\n<\/ol><\/dd>\nWill offloading break my existing image URLs?<\/h3><\/dt>\n
srcset<\/code> attributes all keep working. Nothing in your post content is edited, and no database search-replace is needed.<\/p><\/dd>\nCan I move my media back to my server later?<\/h3><\/dt>\n
What happens to my images if I deactivate the plugin?<\/h3><\/dt>\n
Do I have to delete my local files?<\/h3><\/dt>\n
Why do I need a custom domain or CDN URL?<\/h3><\/dt>\n
Can I keep my access keys out of the database?<\/h3><\/dt>\n
wp-config.php<\/code> \u2014 for example OMNIOFFLOADER_CLOUDFLARE_R2_KEY<\/code> and OMNIOFFLOADER_CLOUDFLARE_R2_SECRET<\/code>. The plugin prefers constants over stored values, and the settings screen marks those fields as locked. Secrets are never sent back to the browser in either case.<\/p><\/dd>\nHow long does a bulk offload take, and can I close the browser tab?<\/h3><\/dt>\n
Can I run a bulk offload from WP-CLI?<\/h3><\/dt>\n
wp omnioffloader offload --all\nwp omnioffloader offload --all --limit=500\nwp omnioffloader restore --all\nwp omnioffloader status\n<\/code><\/pre>\n\n--dry-run<\/code>, and destructive options ask for confirmation unless you pass --yes<\/code>. The command refuses to run while a bulk job started from the admin screen is active, so the two can never touch the same files at once.<\/p><\/dd>\nWhat about very large videos or files?<\/h3><\/dt>\n
Does this plugin work on multisite?<\/h3><\/dt>\n
0.1.1<\/h4>\n\n
\n
post.php<\/code>) with cloud storage status, provider, bucket, offloaded date, CDN status, and one-click actions.<\/li>\nAsyncUploadProcessor<\/code> to offload new uploads in the background without delaying server responses.<\/li>\n--limit=<number><\/code> to wp omnioffloader offload<\/code> for running bulk jobs in manageable chunks.<\/li>\n<\/ul>\n\n\n
AbstractBulkProcessor<\/code>): claims items before processing so a worker killed by host time limits drops the item instead of getting stuck in an infinite retry loop.<\/li>\n\n
document.hidden<\/code>) to pause polling and conserve resources when browser tabs are inactive.<\/li>\n0.1.0<\/h4>\n\n
\n
wp omnioffloader offload<\/code>, wp omnioffloader restore<\/code>, and wp omnioffloader status<\/code>.<\/li>\n<\/ul>","raw_excerpt":"Offload media to Amazon S3, Cloudflare R2, Wasabi or any S3 storage, serve it from a CDN, and restore it anytime with Bring Back.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/356907","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=356907"}],"author":[{"embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/huzaifaalmesbah"}],"wp:attachment":[{"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=356907"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=356907"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=356907"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=356907"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=356907"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=356907"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}