Docs

BuddyBoss

4 min readUpdated November 9, 2026

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 mediaOffloaded and served from the CDN?
Activity photos (Media module)Yes
Documents (Document module)Yes
Videos and video thumbnails (Video module)Yes
Member and group avatarsNo, always local
Member and group cover photosNo, always local

What the integration does#

BuddyBoss card on the Integrations tab

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 filterWhat WP Media Cloud returns
bb_media_do_symlink, bb_document_do_symlink, bb_video_do_symlink, bb_video_create_thumb_symlinksfalse, so BuddyBoss creates no symlinks
bp_media_get_preview_image_urlThe photo URL from WordPress, which is the CDN URL once offloaded
bp_document_get_preview_urlThe document preview image URL from WordPress
bb_video_get_thumb_urlThe video thumbnail URL from WordPress
bb_video_get_symlinkThe video file URL from WordPress
bb_media_offload_deliveredtrue, telling BuddyBoss that an offload plugin delivers the files
bb_media_offload_delivery_providerWP 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.

  1. In Media Cloud > Settings, make sure Offload on upload and Rewrite URLs are on.
  2. Offload existing BuddyBoss uploads with Offload All Media in the Dashboard Bulk Offload card.
  3. 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 seeWhat it meansHow to fix it
Avatars and cover photos load from your siteExpected. They are not Media Library filesNothing to fix. Keep them on your server
Activity photos load from your siteRewrite URLs is off, or the photo is not offloaded yetTurn on Rewrite URLs, then run Offload All Media
Private or group media is broken after turning on Remove local filesA cached page still holds an old symlink URL, or the item is not offloadedClear your page cache. Check the item’s URL in the Media Library and the Dashboard Bulk Offload card for failed items
Video thumbnails are missingThe thumbnail attachment is not offloaded yetRun Offload All Media
A module shows Not active on the Integrations pageThat BuddyBoss component is switched off in BuddyBoss settingsTurn the component on in BuddyBoss if you use it

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only