Sébastien Dumont

<blockquote>
Originally called “WP Offload S3 – Filter Image File Types” but had to be changed for trademark reasons.
</blockquote>
This plugin stops only images from uploading directly to your <a href="http://aws.amazon.com/s3/" rel="nofollow ugc">Amazon S3</a>, <a href="https://www.digitalocean.com/products/spaces/" rel="nofollow ugc">DigitalOcean Spaces</a> or <a href="https://cloud.google.com/storage/" rel="nofollow ugc">Google Cloud Storage</a> by filtering <a href="https://deliciousbrains.com/wp-offload-media/" rel="nofollow ugc">WP Offload Media</a>. All other media file types continue to upload.
This is great for those who are wanting better SEO Image search results as the images will be loading from your site and not from your CDN of choice.
<h4>Contribute and Report Bugs</h4>
You can <a href="https://github.com/seb86/block-uploading-images-for-wp-offload-media/blob/master/.github/CONTRIBUTING.md" rel="nofollow ugc">contribute code</a> to this plugin via the <a href="https://github.com/seb86/block-uploading-images-for-wp-offload-media/blob/master/.github/CONTRIBUTING.md" rel="nofollow ugc">GitHub</a> repository.
<h4>Support</h4>
Use the WordPress.org forums for <a href="https://wordpress.org/support/plugin/wp-offload-s3-filter-image-file-types" rel="ugc">community support</a>. If you spot a bug, you can of course log it on <a href="https://github.com/seb86/block-uploading-images-for-wp-offload-media/issues" rel="nofollow ugc">Github</a> instead where I can act upon it more efficiently.
<h4>Please Leave a Review</h4>
Your ratings make a big difference. If you like Block Uploading Images for WP Offload Media, please consider spending a minute or two <a href="https://wordpress.org/support/view/plugin-reviews/wp-offload-s3-filter-image-file-types?rate=5#postform" rel="ugc">leaving a review</a> and tell me what you think about the plugin.
More information
<ul>
<li>Other <a href="https://profiles.wordpress.org/sebd86/" rel="nofollow ugc">WordPress plugins</a> by <a href="https://sebastiendumont.com/" rel="nofollow ugc">Sébastien Dumont</a></li>
<li>Contact Sebastien on Twitter: <a href="http://twitter.com/sebd86" rel="nofollow ugc">@sebd86</a></li>
<li>If you’re a developer yourself, follow or contribute to the <a href="https://github.com/seb86/block-uploading-images-for-wp-offload-media" rel="nofollow ugc">Block Uploading Images for WP Offload Media plugin on GitHub</a></li>
</ul>

Block Uploading Images for WP Offload Media

Stops images from uploading directly to your choice of CDN storage service.

Masoud Golchin

WP Fitter

Reza Bahreynipour

Morteza Mohammadnezhad

Advanced Media Offloader helps you optimize your WordPress media handling by automatically uploading your media files to S3-compatible cloud storage services.
Struggling with server space limitations? Want to improve your site’s performance by serving media through a CDN? This plugin handles the technical work of migrating your media to the cloud, rewriting URLs, and maintaining compatibility with your existing content.
<h4>Key Benefits</h4>
<ul>
<li>Reduce server storage requirements and costs</li>
<li>Decrease server load when serving media files</li>
<li>Improve global site loading speeds when combined with CDN services</li>
<li>Maintain full compatibility with WordPress media functions</li>
<li>No need to modify existing content – URLs are automatically rewritten</li>
</ul>
<h4>Supported Cloud Providers</h4>
<ul>
<li>Amazon S3 – The industry standard object storage service</li>
<li>Cloudflare R2 – S3-compatible storage with zero egress fees</li>
<li>DigitalOcean Spaces – Simple object storage from DigitalOcean</li>
<li>Backblaze B2 – Affordable S3-compatible storage with predictable pricing</li>
<li>Wasabi – Hot cloud storage with predictable pricing</li>
<li>MinIO – Any S3-compatible storage (MinIO, OVHcloud Object Storage, Scaleway, Linode, Vultr, IBM COS, and more)</li>
</ul>
Not sure which provider to choose? Check our <a href="https://wpfitter.com/blog/best-cloud-storage-for-wordpress-media-pricing-comparison/?utm_source=wp-plugin&utm_medium=readme&utm_campaign=advanced-media-offloader&utm_content=pricing-comparison" rel="nofollow ugc">cloud storage pricing comparison</a> for real-world cost breakdowns.
<h3>Features</h3>
<ul>
<li>Automatic Offloading – New media uploads are automatically sent to your cloud storage</li>
<li>Smart Policies – Create advanced rules to control exactly which files are offloaded and when, giving you granular control over your storage. (<a href="https://wpfitter.com/blog/implementing-smart-retention-policies-with-advanced-media-offloader/?utm_source=wp-plugin&utm_medium=readme&utm_campaign=advanced-media-offloader&utm_content=smart-policies" rel="nofollow ugc">Learn more</a>)</li>
<li>Bulk Migration & WP CLI – Easily move existing media to the cloud with powerful command-line support for bulk operations and automation (<a href="https://wpfitter.com/blog/advmo-bulk-offload-with-wp-cli/?utm_source=wp-plugin&utm_medium=readme&utm_campaign=advanced-media-offloader&utm_content=bulk-offload-cli" rel="nofollow ugc">Learn more</a>)</li>
<li>Thumbnail Regeneration Compatibility – Compatible with WP-CLI <code>wp media regenerate</code> command and the Regenerate Thumbnails plugin. Regenerated thumbnails automatically offload to cloud storage. Note: Not compatible with Full Cloud Migration retention policy.</li>
<li>Smart URL Rewriting – All media URLs are automatically rewritten to serve from cloud storage</li>
<li>File Versioning – Add unique timestamps to media paths to prevent caching issues</li>
<li>Flexible Retention – Choose to keep local copies or remove them after successful offloading</li>
<li>Mirror Deletion – Optionally remove files from cloud storage when deleted from WordPress</li>
<li>Custom Paths – Configure custom path prefixes in your cloud storage</li>
<li>Image Optimizer Compatibility – Works with <a href="https://wordpress.org/plugins/webp-uploads/" rel="ugc">Modern Image Formats</a> (recommended), Imagify, and EWWW Image Optimizer. Optimized WebP and AVIF files are automatically offloaded alongside originals. (<a href="https://wpfitter.com/blog/ewww-imagify-support-added-to-advanced-media-offloader/?utm_source=wp-plugin&utm_medium=readme&utm_campaign=advanced-media-offloader&utm_content=image-optimizer-compatibility" rel="nofollow ugc">Learn more</a>)</li>
<li>Developer-Friendly – Extensive action and filter hooks for extending functionality (<a href="https://wpfitter.com/documents/advanced-media-offloader/development-hooks/?utm_source=wp-plugin&utm_medium=readme&utm_campaign=advanced-media-offloader&utm_content=developer-hooks" rel="nofollow ugc">View Documentation</a>)</li>
</ul>
<h4>Developer Documentation</h4>
For developers looking to extend or customize the plugin behavior, we provide comprehensive documentation for all available hooks:
<a href="https://wpfitter.com/documents/advanced-media-offloader/development-hooks/?utm_source=wp-plugin&utm_medium=readme&utm_campaign=advanced-media-offloader&utm_content=developer-hooks" rel="nofollow ugc">View Developer Hooks Documentation →</a>
Quick example – skip offloading files larger than 5MB:
<pre><code>add_filter('advmo_should_offload_attachment', function($should_offload, $attachment_id) {
 $file = get_attached_file($attachment_id);
 if ($file && filesize($file) > 5 * 1024 * 1024) {
 return false;
 }
 return $should_offload;
}, 10, 2);
</code></pre>
<h3>Configuration</h3>
For security, cloud provider credentials are stored in your <code>wp-config.php</code> file rather than the database.
Note: Domain and endpoint URLs will automatically be prefixed with <code>https://</code> if you don’t include it, but we recommend always including the full URL for clarity.
<a href="https://developers.cloudflare.com/r2/" rel="nofollow ugc">Cloudflare R2</a> Configuration
<pre><code> define('ADVMO_CLOUDFLARE_R2_KEY', 'your-access-key');
 define('ADVMO_CLOUDFLARE_R2_SECRET', 'your-secret-key');
 define('ADVMO_CLOUDFLARE_R2_BUCKET', 'your-bucket-name');
 define('ADVMO_CLOUDFLARE_R2_DOMAIN', 'your-domain-url');
 define('ADVMO_CLOUDFLARE_R2_ENDPOINT', 'your-endpoint-url');
</code></pre>
<a href="https://www.digitalocean.com/products/spaces" rel="nofollow ugc">DigitalOcean Spaces</a> Configuration
<pre><code> define('ADVMO_DOS_KEY', 'your-access-key');
 define('ADVMO_DOS_SECRET', 'your-secret-key');
 define('ADVMO_DOS_BUCKET', 'your-bucket-name');
 define('ADVMO_DOS_DOMAIN', 'your-domain-url');
 define('ADVMO_DOS_ENDPOINT', 'your-endpoint-url');
</code></pre>
<a href="https://min.io/docs/minio/linux/administration/identity-access-management/minio-user-management.html" rel="nofollow ugc">MinIO</a> Configuration
Use this for any storage that supports the S3 API via a custom endpoint (e.g., MinIO, OVHcloud Object Storage, Scaleway, Linode, Vultr, IBM COS). Select this if your provider isn’t listed separately.
<pre><code> define('ADVMO_MINIO_KEY', 'your-access-key');
 define('ADVMO_MINIO_SECRET', 'your-secret-key');
 define('ADVMO_MINIO_BUCKET', 'your-bucket-name');
 define('ADVMO_MINIO_DOMAIN', 'your-domain-url');
 define('ADVMO_MINIO_ENDPOINT', 'your-endpoint-url');
 define('ADVMO_MINIO_PATH_STYLE_ENDPOINT', false); // Optional. Set to true if your MinIO server requires path-style URLs (most self-hosted MinIO setups). Default is false.
 define('ADVMO_MINIO_REGION', 'your-bucket-region'); // Optional. Set your MinIO bucket region if needed. Default is 'us-east-1'.
</code></pre>
<a href="https://aws.amazon.com/s3/" rel="nofollow ugc">Amazon S3</a> Configuration
<pre><code> define('ADVMO_AWS_KEY', 'your-access-key');
 define('ADVMO_AWS_SECRET', 'your-secret-key');
 define('ADVMO_AWS_BUCKET', 'your-bucket-name');
 define('ADVMO_AWS_REGION', 'your-bucket-region');
 define('ADVMO_AWS_DOMAIN', 'your-domain-url');
</code></pre>
<a href="https://www.backblaze.com/apidocs/introduction-to-the-s3-compatible-api" rel="nofollow ugc">Backblaze B2</a> Configuration
<pre><code> define('ADVMO_BACKBLAZE_B2_KEY', 'your-application-key-id');
 define('ADVMO_BACKBLAZE_B2_SECRET', 'your-application-key');
 define('ADVMO_BACKBLAZE_B2_BUCKET', 'your-bucket-name');
 define('ADVMO_BACKBLAZE_B2_REGION', 'your-bucket-region');
 define('ADVMO_BACKBLAZE_B2_DOMAIN', 'your-domain-url');
 define('ADVMO_BACKBLAZE_B2_ENDPOINT', 'your-endpoint-url');
</code></pre>
<a href="https://docs.wasabi.com/docs/creating-a-new-access-key" rel="nofollow ugc">Wasabi</a> Configuration
<pre><code> define('ADVMO_WASABI_KEY', 'your-access-key');
 define('ADVMO_WASABI_SECRET', 'your-secret-key');
 define('ADVMO_WASABI_BUCKET', 'your-bucket-name');
 define('ADVMO_WASABI_REGION', 'your-bucket-region');
 define('ADVMO_WASABI_DOMAIN', 'your-domain-url');
</code></pre>
<h3>Using the S3 PHP SDK</h3>
The Advanced Media Offloader utilizes the AWS SDK for PHP to interact with S3-compatible cloud storage. This powerful SDK provides an easy-to-use API for managing your cloud storage operations, including file uploads, downloads, and more. The SDK is maintained by Amazon Web Services, ensuring high compatibility and performance with S3 services.
For more information about the AWS SDK for PHP, visit: 
<a href="https://aws.amazon.com/sdk-for-php/" rel="nofollow ugc">https://aws.amazon.com/sdk-for-php/</a>

Advanced Media Offloader


This plugin really sped up my website by offloading media to the cloud.



Highly recommend!


Improved Site Speed


Works perfectly. Only miss the WP CLI integration for quick mass upload (which already seems to be under the developer radar). Great job!


Great, Simple and Fully Functional


Fantastic plugin. Easy to setup and rolling. All working fine with no issue. 



Much appreciated for the effort you guys put in. 



Thank you


Great Plugin - Recommend

Save server space & speed up your site by automatically offloading media to Amazon S3, Cloudflare R2 & more.

Block Uploading Images for WP Offload Media vs Advanced Media Offloader