[Skip to content](#main)

[→](/)

[![Avunu](/brand/avunu-logo.svg)![Avunu](/brand/avunu-logo-light.svg)](/)[Services](/services/)[Consulting](/services/consulting/)[ERP](/services/erp/)[Odoo](/services/erp/odoo/)[ERPNext](/services/erp/erpnext/)[Custom software](/services/custom-software/)[Devices & IoT](/services/devices-iot/)[Websites](/services/websites/)[Infrastructure](/services/infrastructure/)[Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

[About Avunu](/about/)[Team](/about/team/)[Insights](/insights/)[Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

- [Services](/services/)[Consulting](/services/consulting/)
- [ERP](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)
- [Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

- [About Avunu](/about/)
- [Team](/about/team/)
- [Insights](/insights/)
- [Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

WP Cloud Files

Stores and serves the WordPress media library from S3-compatible object storage, with direct browser uploads and document thumbnails.

[Open source](/open-source/)

WP Cloud Files

WordPressActiveGPL-3.0-or-later

[View on GitHub (opens in a new tab)](https://github.com/Avunu/wp-cloud-files)[Documentation (opens in a new tab)](https://docs.avunu.net/wp-cloud-files/)

PlatformWordPress

LicenseGPL-3.0-or-later

StatusActive

Repository[Avunu/wp-cloud-files](https://github.com/Avunu/wp-cloud-files)

Part of

Used in

Media libraries grow until they crowd the server, slow down backups, and make it hard to scale or move a site. WP Cloud Files moves uploads to S3-compatible storage such as AWS S3, Cloudflare R2, DigitalOcean Spaces, or MinIO, and serves them from there. Your server stays small, and the media survives a rebuild. Configuration is a handful of constants in `wp-config.php`.

## Features

**Automatic offload.** WordPress resizes images and generates WebP or AVIF variants as usual, then the files go to your bucket and URLs are rewritten to its public address.

**Direct uploads.** An opt-in mode sends files straight from the browser to S3 with short-lived presigned URLs, bypassing proxy upload limits such as Cloudflare's 100 MB cap. Image sizes are generated afterward in the background.

**Document thumbnails** for PDF, Word, Excel, and PowerPoint files, shown in the media library like image thumbnails.

**Migration.** A WP-CLI command moves an existing library to S3 in batches, with options to keep local copies or force re-upload.

**Safe development copies.** Outside production, the plugin can run read-only with no keys, serving existing media without writing to the production bucket.

**Self-updating** from GitHub Releases.

## Getting started

Download the release zip from [GitHub Releases](https://github.com/Avunu/wp-cloud-files/releases/latest), upload it as a plugin, and define your bucket constants in `wp-config.php`. The [README](https://github.com/Avunu/wp-cloud-files#configuration) lists every constant and the bucket CORS rule direct uploads need. Requires PHP 8.3.

Highlights

Uploads move to S3 after WordPress finishes processing themMedia served from your bucket's public URLOptional direct browser-to-S3 uploads for large filesThumbnails for PDF, Word, Excel, and PowerPoint filesWP-CLI command to migrate an existing library

Related projects

[All open-source projects](/open-source/)

[WordPress JWT Auth](/open-source/wordpress-jwt-auth/)

Active

Replaces WordPress logins with single sign-on through an OIDC provider or an identity-aware proxy, configured entirely in wp-config.php.

MIT[GitHub](https://github.com/Avunu/wordpress-jwt-auth)

[WordPress Cloudflare Email](/open-source/wordpress-cloudflare-email/)

Active

Routes all WordPress email through the Cloudflare Email Sending API and keeps a searchable log of every message, with no settings screen.

MIT[GitHub](https://github.com/Avunu/wordpress-cloudflare-email)

Need help with it?

Need this implemented? Our Websites team can move your media to object storage as part of hosting.

[Explore Websites](/services/websites/)[Start a project](/start/)

Services

- [ERP implementation](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)

Resources

- [Our work](/work/)
- [Open source](/open-source/)
- [Knowledge base](/kb/)
- [Insights](/insights/)

Company

- [About](/about/)
- [Team](/about/team/)
- [Partners](/partners/)
- [Contact](/contact/)

Clients

- [Project portal](https://erp.avunu.net/projects)
- [Invoices](https://erp.avunu.net/)
- [Support](https://erp.avunu.net/)

[![Avunu](/brand/avunu-logo-light.svg)](/)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M20.400 20.500h-3.600v-5.600c0-1.300 0-3-1.800-3s-2.100 1.400-2.100 2.900v5.700H9.400V9h3.400v1.600c.5-.9 1.600-1.900 3.400-1.900 3.600 0 4.300 2.400 4.300 5.500v6.300zM5.300 7.400a2.100 2.100 0 1 1 0-4.100 2.100 2.100 0 0 1 0 4.100zm1.800 13.100H3.600V9h3.500v11.500zM22.200 0H1.800C.8 0 0 .8 0 1.700v20.600c0 .9.800 1.700 1.800 1.700h20.400c1 0 1.800-.8 1.800-1.700V1.700C24 .8 23.200 0 22.200 0z">\</path>\</svg>\</av-icon>](https://www.linkedin.com/company/avunu)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M12 .3a12 12 0 0 0-3.8 23.4c.6.1.8-.3.8-.6v-2c-3.3.7-4-1.6-4-1.6-.6-1.4-1.4-1.8-1.4-1.8-1-.7.1-.7.1-.7 1.2.1 1.8 1.2 1.8 1.2 1 1.8 2.8 1.3 3.5 1 .1-.8.4-1.3.7-1.6-2.7-.3-5.5-1.3-5.5-5.9 0-1.3.5-2.4 1.2-3.2-.1-.3-.5-1.5.1-3.2 0 0 1-.3 3.3 1.2a11.500 11.500 0 0 1 6 0c2.300-1.500 3.300-1.200 3.300-1.200.6 1.700.2 2.900.1 3.200.8.8 1.200 1.900 1.200 3.200 0 4.600-2.800 5.600-5.500 5.900.4.400.8 1.100.8 2.200v3.300c0 .3.2.7.8.6A12 12 0 0 0 12 .3">\</path>\</svg>\</av-icon>](https://github.com/Avunu)[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

Avunu LLC · 948 East Philadelphia Street, York, PA 17403 · (717) 814-8540Knowledge base articles are in the public domain[Privacy](/privacy/)[Terms](/terms/)
