S3 Uploads #1 in Media & Images
WordPress plugin to store uploads on S3
★ 2.1kstars
51krelease downloads
≈30active sites
2.6Mcomposer installs
402forks
Install
The author publishes release zips, so WP-CLI can install straight from GitHub:
wp plugin install https://github.com/humanmade/s3-uploads/releases/download/3.0.10/manual-install.zipAlso on Packagist as humanmade/s3-uploads:
composer require humanmade/s3-uploadsFrom the readme
S3 Uploads
Lightweight "drop-in" for storing WordPress uploads on Amazon S3 instead of the local filesystem.
A Human Made project. Maintained by @joehoyle.
S3 Uploads is a WordPress plugin to store uploads on S3. S3 Uploads aims to be a lightweight "drop-in" for storing uploads on Amazon S3 instead of the local filesystem.
It's focused on providing a highly robust S3 interface with no "bells and whistles", WP-Admin UI or much otherwise. It comes with some helpful WP-CLI commands for generating IAM users, listing files on S3 and Migrating your existing library to S3.
Requirements
- PHP = 7.4
- WordPress = 5.3
Getting Set Up
S3 Uploads requires installation via Composer:
Note: Composer's autoloader must be loaded before S3 Uploads is loaded. We recommend loading it in your wp-config.php before wp-settings.php is loaded as shown below.
Configuration
Once you've installed the plugin, add the following constants to your wp-config.php:
Please refer to this Region list for the S3UPLOADSREGION values.
Use of path prefix after the bucket name is allowed and is optional. For example, if you want to upload
Read the full README on GitHub →
Releases
| Tag | Published | Asset | Downloads |
|---|---|---|---|
| 3.0.13 | Feb 25, 2026 | — | — |
| 3.0.12 | Feb 17, 2026 | — | — |
| 3.0.11 | Oct 22, 2025 | — | — |
| 3.0.10 | Aug 7, 2025 | manual-install.zip | 1,820 |
| 3.0.10 | Aug 7, 2025 | — | — |
| 3.0.9 | Jun 6, 2025 | manual-install.zip | 359 |
| 3.0.9 | Jun 6, 2025 | — | — |
| 3.0.8 | Jun 3, 2025 | manual-install.zip | 25 |
| 3.0.8 | Jun 3, 2025 | — | — |
| 3.0.7 | May 4, 2023 | manual-install.zip | 18,647 |
| 3.0.7 | May 4, 2023 | — | — |
| 3.0.6 | Nov 29, 2022 | manual-install.zip | 2,139 |
| 3.0.6 | Nov 29, 2022 | — | — |
| 3.0.5 | Nov 28, 2022 | — | — |
| 3.0.4 | Mar 2, 2022 | manual-install.zip | 8,219 |
| 3.0.4 | Mar 2, 2022 | — | — |
| 3.0.3 | Jul 30, 2021 | manual-install.zip | 2,418 |
| 3.0.3 | Jul 30, 2021 | — | — |
| 3.0.2 | Jun 17, 2021 | manual-install.zip | 304 |
| 3.0.2 | Jun 17, 2021 | — | — |
| 3.0.1 | Jun 16, 2021 | — | — |
| 3.0.0 | Apr 20, 2021 | — | — |
| 3.0.0-beta1 | Apr 1, 2021 | — | — |
| 2.3.0 | Mar 18, 2021 | manual-install.zip | 13,972 |
| 2.3.0 | Mar 18, 2021 | — | — |
Active-site estimate ≈30 comes from the median of recent superseded releases. Method.