Storage plugins for Payload CMS 11

Work with files that already sit in Payload CMS storage. Browse S3 buckets in the admin, clean up orphaned files and proxy production files locally.

Lets editors crop uploaded images in a modal and generates resized variants per preset

Browse upload folders inside Payload's document drawers

Fetches missing media files from a production site during local development

Finds orphaned files and unreferenced documents, then deletes only what you approve

Builds sitemap.xml files from Payload content and keeps them fresh

Backs up and restores MongoDB data and media to Vercel Blob or S3 from the admin

Adds a Sirv DAM browser to Payload fields for images, videos, 360 spins and 3D models

Browse, upload and delete S3 bucket files from the Payload admin

Transcodes uploaded videos into HLS streams at several resolutions for adaptive playback

Adds purchase-gated digital file downloads to the Payload ecommerce product catalog

Appends a content hash to uploaded filenames so CDN caching can run longer

About these packages

Storage plugins work with files that already sit in your Payload upload collections. They do not decide where files are written. A storage adapter does that and writes the files to S3, R2 or another service. The plugins here sit next to it in the plugins array and take care of browsing, cleanup and naming.

What these plugins cover

  • Storage File Explorer for browsing S3 buckets in the admin
  • Janitor for finding orphaned files and unreferenced documents
  • Files Proxy for production files missing in local development
  • Hash Upload for hashed filenames
  • Folder Picker for choosing folders in upload drawers
  • Video handoff to Mux, covered on the media plugins page

Choosing a storage plugin

To choose where uploads are stored, start with the storage adapters. They also cover a GitHub repository or Alibaba Cloud OSS. Pick a plugin here by the job you have. Janitor finds and removes orphaned files. Files Proxy fetches production files that are missing in local development. Storage File Explorer lets you look through a bucket from the admin. Video handoff to Mux is among the media plugins, and site backups are among the migration plugins.

Frequently asked questions

What is the difference between a storage adapter and a storage plugin in Payload?

A storage adapter decides where upload files are written, for example S3, R2 or a GitHub repository. A storage plugin works with files that are already stored. Database adapters such as DynamoDB Adapter belong in the adapters catalog, not here.

How do I get production uploads in local development?

Files Proxy fetches upload files that are missing on your machine from the production site during local development. You don't have to copy the whole media folder.

How do I delete unused files from Payload uploads?

Janitor finds orphaned files and documents that nothing references. It then deletes only what you approve. Make a backup first. Backup plugins are among the migration plugins.