Private MediaPRO
Private Media lets you keep individual files out of public reach, for example paid downloads, member-only documents, or client files, while the rest of your library stays public.
A private file is moved to a separate private path in your bucket. It has no public link. Every time it’s displayed, the plugin generates a signed URL that stops working after a few minutes.
Requirements
| Storage | Delivery that supports Private Media |
|---|---|
| Amazon S3 | Amazon S3, Amazon CloudFront, Bunny.net |
| Google Cloud Storage | Google Cloud Storage. Add Prefix to Bucket Path must be on, and Block All Public Access must be off. |
| DigitalOcean Spaces | DigitalOcean Spaces, Bunny.net |
| Cloudflare R2, S3-compatible | Not available |
An active Pro license is required. Options that support it have a Private media tag on the delivery screen.
Step 1: Turn on Private Media
- Go to Media Cloud Sync → Settings.
- In the Delivery column, turn on Private Media.
- Set the options:FieldDefaultDescriptionPrivate Path
privateFolder for private files. It sits next to your bucket prefix, not inside it. For example,private/wp-content/uploads/…Private URL Lifetime (minutes)20How long each signed URL works. - Click Save Changes.

Step 2: Apply the bucket policy
Saving the settings doesn’t change your bucket. To make the private path actually private:
- Under Apply Bucket Policy, click Apply Policy.
- The status changes from Not Applied to Applied, with the message “Private files are currently excluded from public access on your bucket.”
What applying the policy does:
- Amazon S3 / DigitalOcean Spaces: rewrites the bucket’s public-read policy so that it covers everything except the private path.
- Google Cloud Storage: uses Managed Folders to keep your base path public and everything else private. This removes public access from anything in the bucket outside your base path, including files this plugin didn’t upload.
Important: Apply Policy uses your saved settings. If you change the private path later, save first and click Apply Policy again.
Step 3: Mark files as private
- Go to Media → Library.
- On a synced item, open the Media Cloud Sync actions (the ⋮ menu in list view, or the attachment details in grid view).
- Click Mark as Private.
The file and all its sizes are moved to the private path. Wherever the file appears on your site, its URL becomes a signed URL that expires after the configured lifetime.
To undo, choose Mark as Public on the same item.
You can also select several items and use Mark as Private / Mark as Public from the Media Cloud Sync actions bulk dropdown. See Managing Media from the Media Library.
Private Media behind a CDN
With CloudFront or Bunny.net as your delivery provider, private files are signed by the CDN. Extra fields appear under Private Media:
Amazon CloudFront
| Field | Description |
|---|---|
| CloudFront Distribution ID | Apply Policy lets only this distribution read private files from your bucket. Attach an Origin Access Control to the distribution’s S3 origin. |
| Public Key ID | From a CloudFront key group. Add a behavior for the private path restricted to that key group (Restrict viewer access). |
| Private Key (PEM) | The private key matching the public key above, including the BEGIN/END lines. |
Bunny.net
| Field | Description |
|---|---|
| Private Pull Zone Hostname | A separate Bunny pull zone for private files, with Token Authentication on and S3 authentication to your bucket. Its origin must serve files at /{object key}. |
| Token Authentication Key | The private pull zone’s URL Token Authentication key (Security tab). |
These keys aren’t included when you export settings.
Turning Private Media off
- Mark any private items as public first. The plugin won’t let you change the private path while items are still private under the previously applied path.
- Click Remove Policy.
- Turn off Private Media and click Save Changes.
Good to know
- Signed URLs expire. A visitor who keeps a page open longer than the URL lifetime has to reload to get a fresh link. Very short lifetimes can break long video playback.
- Page caching: full-page cache plugins can store an expired signed URL in cached HTML. Use a cache lifetime shorter than the URL lifetime, or exclude pages that show private files. The plugin shows a warning under the toggle when your page cache outlasts private links.
- If Pro is deactivated or the license lapses, private files stay in the private path and aren’t re-uploaded publicly. Re-activate Pro to manage them.