PHPackages                             wpcomvip/s3-media-sync - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File &amp; Storage](/categories/file-storage)
4. /
5. wpcomvip/s3-media-sync

ActiveWordpress-plugin[File &amp; Storage](/categories/file-storage)

wpcomvip/s3-media-sync
======================

Sync full media backups to S3.

1.4.1(1y ago)23614↓20%7[1 PRs](https://github.com/Automattic/s3-media-sync/pulls)PHPPHP ^8.1CI passing

Since Jun 3Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/Automattic/s3-media-sync)[ Packagist](https://packagist.org/packages/wpcomvip/s3-media-sync)[ RSS](/packages/wpcomvip-s3-media-sync/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (6)Dependencies (2)Versions (23)Used By (0)

S3 Media Sync
=============

[](#s3-media-sync)

Stable tag: 1.4.1 Requires at least: 6.4 Tested up to: 6.9 Requires PHP: 8.1 License: GPLv2 or later License URI: Tags: s3, aws, media, sync, cloud storage Contributors: alexiskulash, automattic, wpcomvip

A WordPress plugin that syncs media uploads to Amazon S3, providing reliable cloud storage for your WordPress media library.

Overview
--------

[](#overview)

S3 Media Sync syncs the `uploads` directory of a WordPress environment to an AWS S3 instance, ensuring your media files are safely stored and easily accessible. This plugin is ideal for WordPress sites that need:

- Cloud-based media storage
- Better reliability and scalability for media files
- Improved performance for media-heavy sites

*Props to [S3-Uploads](https://github.com/humanmade/S3-Uploads/) and [Human Made](https://hmn.md/) for creating much of the functionality on which this plugin is based.*

Key Features
------------

[](#key-features)

- **Automatic Syncing**: Automatically uploads media files to S3 as they're added to WordPress
- **WP-CLI Integration**: Command-line tools for bulk operations and management
- **Configurable Storage**: Support for custom bucket paths and AWS regions
- **Simple Setup**: Easy-to-use settings page for configuration

Documentation
-------------

[](#documentation)

For detailed information, please see the documentation in the `docs` directory:

- [Setup Guide](docs/setup.md) - How to install and configure the plugin
- [AWS Setup Guide](docs/aws-setup-guide.md) - Instructions for setting up AWS permissions
- [WP-CLI Commands](docs/wp-cli-commands.md) - Available command-line tools
- [Development Guide](docs/development.md) - Information for developers
- [FAQ](docs/faq.md) - Frequently asked questions

Quick Start
-----------

[](#quick-start)

1. Install and activate the plugin
2. Configure AWS credentials in the settings page
3. Start uploading media to WordPress - it will automatically sync to S3

For full installation instructions, see the [Setup Guide](docs/setup.md).

Change Log
----------

[](#change-log)

[View the change log](https://github.com/Automattic/s3-media-sync/blob/master/CHANGELOG.md).

Support
-------

[](#support)

For issues and feature requests, please [create an issue](https://github.com/Automattic/s3-media-sync/issues) on the GitHub repository.

###  Health Score

51

—

FairBetter than 96% of packages

Maintenance69

Regular maintenance activity

Popularity29

Limited adoption so far

Community23

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 67.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~344 days

Total

6

Last Release

448d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ba7751eebec0f74a4963e9a062f49e58222b97872bf193d95f0505f3df321d09?d=identicon)[GaryJones](/maintainers/GaryJones)

![](https://www.gravatar.com/avatar/7c5869ecbb8e0eac7e8b8e0f3cf7bdd8d5fcdc4abc10a72281872c53f8639d44?d=identicon)[automattic](/maintainers/automattic)

![](https://avatars.githubusercontent.com/u/565973?v=4)[Sean Langlands](/maintainers/seanlanglands)[@seanlanglands](https://github.com/seanlanglands)

---

Top Contributors

[![GaryJones](https://avatars.githubusercontent.com/u/88371?v=4)](https://github.com/GaryJones "GaryJones (123 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (19 commits)")[![ovidiul](https://avatars.githubusercontent.com/u/537751?v=4)](https://github.com/ovidiul "ovidiul (18 commits)")[![seanlanglands](https://avatars.githubusercontent.com/u/565973?v=4)](https://github.com/seanlanglands "seanlanglands (9 commits)")[![bratvanov](https://avatars.githubusercontent.com/u/6027160?v=4)](https://github.com/bratvanov "bratvanov (3 commits)")[![brettshumaker](https://avatars.githubusercontent.com/u/1558827?v=4)](https://github.com/brettshumaker "brettshumaker (3 commits)")[![rebeccahum](https://avatars.githubusercontent.com/u/16962021?v=4)](https://github.com/rebeccahum "rebeccahum (2 commits)")[![matriphe](https://avatars.githubusercontent.com/u/277262?v=4)](https://github.com/matriphe "matriphe (1 commits)")[![PatelUtkarsh](https://avatars.githubusercontent.com/u/5015489?v=4)](https://github.com/PatelUtkarsh "PatelUtkarsh (1 commits)")[![rahulsprajapati](https://avatars.githubusercontent.com/u/10358350?v=4)](https://github.com/rahulsprajapati "rahulsprajapati (1 commits)")[![BrookeDot](https://avatars.githubusercontent.com/u/150348?v=4)](https://github.com/BrookeDot "BrookeDot (1 commits)")[![yolih](https://avatars.githubusercontent.com/u/8527034?v=4)](https://github.com/yolih "yolih (1 commits)")

---

Tags

s3vipwordpresswordpress-pluginwpvip-plugin

### Embed Badge

![Health badge](/badges/wpcomvip-s3-media-sync/health.svg)

```
[![Health](https://phpackages.com/badges/wpcomvip-s3-media-sync/health.svg)](https://phpackages.com/packages/wpcomvip-s3-media-sync)
```

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[humanmade/s3-uploads

WordPress plugin to store uploads on S3

2.1k2.4M9](/packages/humanmade-s3-uploads)[aws/aws-sdk-php-laravel

A simple Laravel 9/10/11/12/13 service provider for including the AWS SDK for PHP.

1.7k35.6M75](/packages/aws-aws-sdk-php-laravel)[fusic/filebinder

Simple file attachment plugin for CakePHP

7230.1k](/packages/fusic-filebinder)[edwardspec/mediawiki-aws-s3

Allows MediaWiki to use Amazon S3 to store uploaded files.

4913.2k](/packages/edwardspec-mediawiki-aws-s3)[mreduar/s3m

Multipart Uploads using Laravel and AWS S3

173.6k](/packages/mreduar-s3m)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
