BuddyBoss
This page explains how WP Media Cloud works with BuddyBoss Platform. Photos, documents and videos uploaded in BuddyBoss are offloaded and served from your CDN. Member and group avatars and cover photos stay on your server.
What gets offloaded#
WP Media Cloud offloads files that are WordPress Media Library attachments. BuddyBoss saves activity photos, documents and videos as attachments, so they are offloaded on upload like any other media.
Avatars and cover photos are different. BuddyBoss stores member avatars, group avatars and cover photos as plain files in their own upload folders. They are never Media Library attachments, so WP Media Cloud never sees them. They always load from your server.
| BuddyBoss media | Offloaded and served from the CDN? |
|---|---|
| Activity photos (Media module) | Yes |
| Documents (Document module) | Yes |
| Videos and video thumbnails (Video module) | Yes |
| Member and group avatars | No, always local |
| Member and group cover photos | No, always local |
What the integration does#

BuddyBoss normally serves media through symlinks in your uploads folder, so that PHP can check who may see each file. Once a file is offloaded and its local copy is removed, those symlinks point at nothing.
WP Media Cloud uses the same BuddyBoss filters that BuddyBoss provides for offload plugins. It hooks them at the highest priority (PHP_INT_MAX) so it runs last. All of this happens on the fly. Nothing is written to the database.
| BuddyBoss filter | What WP Media Cloud returns |
|---|---|
bb_media_do_symlink, bb_document_do_symlink, bb_video_do_symlink, bb_video_create_thumb_symlinks | false, so BuddyBoss creates no symlinks |
bp_media_get_preview_image_url | The photo URL from WordPress, which is the CDN URL once offloaded |
bp_document_get_preview_url | The document preview image URL from WordPress |
bb_video_get_thumb_url | The video thumbnail URL from WordPress |
bb_video_get_symlink | The video file URL from WordPress |
bb_media_offload_delivered | true, telling BuddyBoss that an offload plugin delivers the files |
bb_media_offload_delivery_provider | WP Media Cloud |
What you need to switch on#
There is no BuddyBoss setting in WP Media Cloud. The integration starts when BuddyBoss Platform is active.
- In Media Cloud > Settings, make sure Offload on upload and Rewrite URLs are on.
- Offload existing BuddyBoss uploads with Offload All Media in the Dashboard Bulk Offload card.
- Open Media Cloud > Integrations. The BuddyBoss Platform card shows whether the Activity Media, Documents and Videos modules are active, and notes that Avatars / Covers are Always local.
The Integrations page caches what it detects for up to 5 minutes. Save your settings to refresh it sooner.
Limits#
- Avatars and cover photos stay local. This comes from how BuddyBoss stores them. WP Media Cloud cannot change it. Do not delete the avatar folders from your server.
- Private media uses public CDN links. With symlinks off, BuddyBoss shows the plain CDN URL for private and group media. Anyone who has that link can open the file. If you need strict privacy for member uploads, test this before going live.
- The symlinks are off as soon as BuddyBoss is detected. This applies even to files not yet offloaded. Those show their normal local uploads URL instead of a symlink. Offload existing media before you rely on it.
URL Replace (beta)#
BuddyBoss media URLs are built at display time from attachment IDs. You do not need URL Replace for them.
URL Replace (beta) replaces every local uploads URL it finds in posts, post meta and options, including files outside the Media Library. Avatars and cover photos are not in your bucket. If any of their URLs are stored in those tables, a replace would point them at the CDN, where they do not exist. Check the scan preview and untick anything that is not Media Library media.
Troubleshooting#
| What you see | What it means | How to fix it |
|---|---|---|
| Avatars and cover photos load from your site | Expected. They are not Media Library files | Nothing to fix. Keep them on your server |
| Activity photos load from your site | Rewrite URLs is off, or the photo is not offloaded yet | Turn on Rewrite URLs, then run Offload All Media |
| Private or group media is broken after turning on Remove local files | A cached page still holds an old symlink URL, or the item is not offloaded | Clear your page cache. Check the item’s URL in the Media Library and the Dashboard Bulk Offload card for failed items |
| Video thumbnails are missing | The thumbnail attachment is not offloaded yet | Run Offload All Media |
| A module shows Not active on the Integrations page | That BuddyBoss component is switched off in BuddyBoss settings | Turn the component on in BuddyBoss if you use it |