WP Offload Media Lite for Amazon S3, DigitalOcean Spaces, and Google Cloud Storage
Contributors: wpengine, deliciousbrains, ianmjones, eriktorsner, kevinwhoffman, tysonreeder, dalewilliams, lewisia32, mattshaw, aaemnnosttv, a5hleyrich, polevaultweb, bradt, joetan
Tags: uploads, amazon, s3, amazon s3, digitalocean, digitalocean spaces, google cloud storage, gcs, mirror, admin, media, cdn, cloudfront
Requires at least: 5.9
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 3.4.2
License: GPLv2
Copies files to Amazon S3, DigitalOcean Spaces or Google Cloud Storage as they are uploaded to the Media Library. Optionally configure Amazon CloudFront or another CDN for faster delivery.
Description
FORMERLY WP OFFLOAD S3 LITE
https://www.youtube.com/watch?v=I-wTMXMeFu4
This plugin automatically copies images, videos, documents, and any other media added through WordPress' media uploader to Amazon S3, DigitalOcean Spaces or Google Cloud Storage. It then automatically replaces the URL to each media file with their respective Amazon S3, DigitalOcean Spaces or Google Cloud Storage URL or, if you have configured Amazon CloudFront or another CDN with or without a custom domain, that URL instead. Image thumbnails are also copied to the bucket and delivered through the correct remote URL.
Uploading files directly to your Amazon S3, DigitalOcean Spaces or Google Cloud Storage account is not currently supported by this plugin. They are uploaded to your server first, then copied to the bucket. There is an option to automatically remove the files from your server once they are copied to the bucket however.
If you're adding this plugin to a site that's been around for a while, your existing media files will not be copied to or served from Amazon S3, DigitalOcean Spaces or Google Cloud Storage. Only newly uploaded files will be copied to and served from the bucket. The pro upgrade has an upload tool to handle existing media files.
Image Optimization
Although WP Offload Media doesn't include image optimization features, we work closely with the author of EWWW Image Optimizer to ensure they always work well together. Not only do we recommend EWWW Image Optimizer but we officially support its integration with WP Offload Media.
PRO Upgrade with Email Support and More Features
Compare pro vs free →
The video below runs through the pro upgrade features...
https://www.youtube.com/watch?v=I-wTMXMeFu4
Installation
- Install this plugin using WordPress' built-in installer
- Access the Offload Media option under Settings
- Follow the instructions to set up your AWS or DigitalOcean access keys and configure
Check out the Quick Start Guide for more information on configuring WP Offload Media.
Frequently Asked Questions
What are the minimum requirements?
You can see the minimum requirements here.
Do you offer email support?
If you upgrade to the pro version of WP Offload Media, we will gladly provide you with email support. We take pride in delivering exceptional customer support. We do not provide email support for the free version.
Upgrade Notice
3.4.0
This is a major upgrade that updates the format of information stored about offloaded Media Library items. Once upgraded you will not be able to downgrade without restoring data from a backup.
2.6
This is a major upgrade that updates the format of information stored about offloaded Media Library items. Once upgraded you will not be able to downgrade without restoring data from a backup.
This version requires PHP 5.6+
2.3
This is a major upgrade that switches to using a custom table for storing data about offloaded Media Library items. Once upgraded you will not be able to downgrade without restoring data from a backup.
2.0
This is a major upgrade that introduces support for DigitalOcean Spaces, renames the plugin to WP Offload Media Lite, and coincidentally upgrades some of its database settings. You may not be able to downgrade to WP Offload S3 Lite 1.x after upgrading to WP Offload Media Lite 2.0+.
1.1
This is a major change, which ensures S3 URLs are no longer saved in post content. Instead, local URLs are filtered on page generation and replaced with the S3 version. If you depend on the S3 URLs being stored in post content you will need to make modifications to support this version.
0.6
This version requires PHP 5.3.3+ and the Amazon Web Services plugin
Changelog
WP Offload Media Lite 3.4.2 - 2026-09-07
- Bug fix: A null attachment ID passed to get_attached_file() by another plugin no longer results in a fatal error
- Bug fix: Upgrading while using PHP 8.5 on a multisite no longer raises a fatal error in the cron job in some cases
WP Offload Media Lite 3.4.1 - 2026-09-04
- Bug fix: Rejecting non-string content in AS3CF_Filter::process_content() no longer results in a fatal error
WP Offload Media Lite 3.4.0 - 2026-09-03
- Release Summary Blog Post
- New: For improved performance, a new custom table stores information about each offloaded file
- New: WordPress 7.1 compatible
- New: AWS PHP SDK has been updated to v3.392.1
- New: Google Cloud Storage SDK has been updated to v2.5.1
- New: PHP and JS dependencies have been updated
- Improvement: amazonS3_cache postmeta records replaced with as3cf_url_cache_local and as3cf_url_cache_remote records
- Improvement: Unlike amazonS3_cache records, as3cf_url_cache_* records self-heal when content has URLs added or removed
- Improvement: A full postmeta table scan of amazonS3_cache records is no longer performed when a Media Library item is deleted
- Bug fix: WP 7.1's client side generated thumbnails are now properly removed from local after offload if using Remove Local Media option
- Bug fix: WP 7.1's new source_image, animated_video, and animated_video_poster fields for Media Library metadata properly handled
- Bug fix: WP 7.1's changes to customizer cropped image metadata now handled to properly offload item and remove downloaded original as appropriate
- Bug fix: The URL for a background image applied to a template part’s group block is now properly rewritten on the frontend
- Bug fix: Missing custom tables are now created even if settings say they should already exist, e.g. if site partially migrated
- Bug fix: Implicitly marking parameter $limit as nullable is deprecated message no longer emitted to debug log during upgrades with PHP 8.5
- Bug fix: URLs containing some specific CJK characters are now properly rewritten when the PHP build strips certain control characters
- Bug fix: WP_Filesystem init failure is properly reported while removing local media
WP Offload Media Lite 3.3.1 - 2026-04-15
- New: Google Cloud Storage SDK has been updated to v1.49.2
- New: PHP and JS dependencies have been updated
- New: WordPress 7.0 compatible
- Improvement: The current bucket's location is no longer checked when the region is defined as a constant
- Removed: The StackPath (no longer in business) delivery provider has been marked as deprecated and can no longer be selected in the UI
- Bug fix: Editing a footer template with an existing offloaded and removed from local image block now properly shows the image
- Bug fix: Returning to the site editor with an offloaded and removed from local background image applied to a group block now properly shows the image
- Bug fix: The Customizer now correctly shows just added and cropped remote only header images
- Bug fix: The original remote only image downloaded during a Customizer header image crop is now properly re-removed from the server
- Bug fix: Checking settings after manually changing a bucket's ACL enablement status no longer results in delivery status validation problems
- Bug fix: Offload and remove from local triggered from outside the admin context no longer sometimes results in a fatal error
WP Offload Media Lite 3.3.0 - 2026-02-03
- Release Summary Blog Post
- New: Amazon S3 regions Asia Pacific (Taipei) and Asia Pacific (New Zealand) are now selectable
- New: Google Cloud Storage regions North America (Querétaro) and Europe (Stockholm) are now selectable
- New: DigitalOcean Spaces region Atlanta (ATL1) is now selectable
- New: WordPress 6.9 compatible
- New: Requires WordPress 5.9+
- New: PHP 8.4 compatible
- New: PHP 8.5 compatible
- New: Requires PHP 8.1+
- New: AWS PHP SDK has been updated to v3.360.1
- New: PHP and JS dependencies have been updated
- Improvement: The filesize attachment metadata value is no longer removed when the item is downloaded
- Bug fix: The legacy file size upgrade routine no longer throws an error if attachment metadata is missing
- Bug fix: Deleting an item via the Media Library's grid mode now works when Rank Math SEO is installed
- Bug fix: The plugin now protects against an invalid value being passed to the core
the_post action
WP Offload Media Lite 3.2.12 - Unreleased
WP Offload Media Lite 3.2.11 - 2025-01-22
- New: Amazon S3 regions Asia Pacific (Thailand) and Mexico (Central) are now selectable
WP Offload Media Lite 3.2.10 - 2024-12-12
- New: DigitalOcean regions Toronto (TOR1) and London (LON1) are now selectable
- New: Google Cloud Storage regions Africa (Johannesburg), Dual-Region (Belgium/London), Dual-Region (London/Frankfurt) and Dual-Region (Frankfurt/Zürich) are now selectable
- New: Google Cloud Storage SDK has been updated to v1.39.0 (requires PHP 7.4+)
- Bug fix: Speed of adding new media is no longer affected by the number of records in the postmeta table
WP Offload Media Lite 3.2.9 - 2024-10-04
- Security: The plugin can now serve updates from WP Engine servers, however this update mechanism is not included when installed directly from WordPress.org