WP Offload S3 1.1 Released

Today is release day for WP Offload S3 and with it comes some new features and some changes.

The free edition of the plugin has been renamed to “WP Offload S3 Lite” and is now at version 1.0. The commercial plugin is now called “WP Offload S3” and is a standalone plugin at version 1.1, built on top of the free plugin. You will no longer need to run the plugins together and they actually enforce that by deactivating themselves when necessary.

Reorganizing the plugins in this way brings WP Offload S3 in line with the approach we use for WP Migrate DB Pro. First, we rigorously test the free edition. When it passes all our tests, we release it. If users report any issues we immediately do a patch release. In parallel we test the paid edition and when it passes all our tests, we release it, usually about a week after the free edition. This means that our customers get the benefit of an extra round of testing and a good portion of the code in use out in the wild before they use it on their site.

License Usage

We’ve listened to the feedback we’ve received since launch and have decided to change how the license usage is calculated. It is now based on the number of items offloaded to S3 rather than total attachments in the Media Library. This is a fairer and less confusing approach for customers.

Download Tool

We have also included a new tool to detect all the missing files from your server and download them from S3. It can take care of replacing S3 URLs with local ones after the download has happened. This tool also brought about a redesign of the sidebar which now incorporates the tool for uploading existing attachments to S3:


Private Toggle

We’ve come across a number of use cases where other plugins that use files offloaded to S3 need the files to be set as private. So we’ve introduced a new handy toggle link when viewing an attachment’s details:


Settings Constant

We have introduced the ability to define any and all of the plugin’s settings via a constant. When a setting is defined in the code, it locks that setting from being changed in the UI. This is true for the Assets addon settings as well.

The ability to define settings in code gives developers further control over the configuration of their sites. For example, adding the below code to your wp-config.php would control the some of the advanced settings:

define( 'WPOS3_SETTINGS', serialize( array(
    'remove-local-file' => false,
    'object-versioning' => true,
) ) );

The ‘Advanced Options’ section on the settings page would then look like this:


See our doc for complete details on how to use the constant.

Simplified Domain Setting

The new version also brings a simplified interface for the ‘Domain’ setting which controlled the format of the S3 URLs.





Read more about the change here.

Docs, Docs and More Docs

You will also notice a peppering of handy ‘Read More’ links through the settings page which point to our documentation to help understand each setting.

New Integration: Advanced Custom Fields Image Crop

As part of this release we have a new addon which integrates with the Advanced Custom Fields Image Crop plugin. This allows you to crop images that have been offloaded to S3 but removed from the server without any issues.

Addon Updates

We have also released new versions of the Assets addon and the Enable Media Replace addon to address a number of bug fixes and improvements, as well as releases to all other addons for compatibility with WP Offload S3 1.1.

Check out the full WP Offload S3 changelog for more details.

About the Author

Iain Poulson

Iain is a WordPress and PHP developer from England. He builds free and premium plugins, as well as occasionally blogging about WordPress. Moonlights as a PhpStorm evangelist.

  • Anthony

    These are some great updates. Thank you so much for this.

  • Good idea for the “Private Toggle” option, but for someone that doesn’t read this blog post, I’m not sure to only have a underline link style on the word is enough to understand the intended goal of this link before trying it. I think it would be good to add something like “Public (toggle privacy)” or something more obvious.

    Nice stuff in this update, I’ll probably give this plugin a Try instead of using W3 Total Cache for my next WordPress project.

  • Gaurav Shandilya

    Great plugin and update thanks. But my website broke after taking the following steps:

    1: Updated WP Offload S3 to 1.1.1
    2: Updated Amazon web services plugin from 0.3.4 to 0.3.5 and straight away I received the 500 error and I could not access my website at all.

    To Fix this, I had to rename the AWS plugin folder to access my admin area->de-activate all WP Offload plugins->Delete AWS Plugin->Re-Install AWS Plugin and lastly Activate WP Offload plugins to get my website to working state.

    Any idea why this has happened?

  • Thanks for the update and the continued support of the plugin. The one area I need a little help understanding is why plugins like WP Retina 2x are considered “redundant” with “the introduction of responsive images in WordPress 4.4” (Per this https://deliciousbrains.com/wp-offload-s3/doc/copy-hidpi-2x-images-support/)

    Reading through the specification for responsive images for WordPress it states create a set of image sizes based on your theme settings to use with the srcset attribute. I don’t believe this guarantees you’ll have retina images supported unless you always upload the same sized images and have a setup your theme to create a 2x version for that standard image size.

    In practice users upload images of all different sizes and I believe using a plugin like Retina 2x is the only way to guarantee you’ll always have a properly sized image that is 2x.

    Am I missing something?

    • Avishai

      Did you ever figure out an answer to this? Do you just create additional “retina” sizes that automatically get added to the `srcset` in WordPress?

  • Tiger HU

    Brilliant work guys!