BuddyBoss
BuddyBoss Platform is a community and membership plugin for WordPress. WP Media Cloud has a dedicated BuddyBoss integration that handles BuddyBoss’s symlink-based private media access system and ensures all BuddyBoss media types are served from cloud storage. There is one permanent limitation: member avatars and cover images cannot be offloaded.
What gets offloaded#
BuddyBoss has several distinct media subsystems. The following are offloaded and served from cloud storage:
- Activity feed photos
- Activity feed documents
- Activity feed videos and video thumbnails
- Message attachment media
- Group media
- Course featured images (when using BuddyBoss with LearnDash or LifterLMS)
All of these go through WordPress’s standard media upload pipeline via media_handle_upload() and become WordPress attachment posts. WP Media Cloud offloads them automatically on upload.
Avatars and cover images — permanent limitation#
Member avatars, group avatars, and member and group cover images are stored as flat files in custom upload directories outside the WordPress media library. They are never registered as WordPress attachment posts. WP Media Cloud only operates on WordPress attachment posts, so it never has visibility into these files. Avatars and cover images are always served from your server’s local file system regardless of WP Media Cloud configuration.
This is an architectural constraint in BuddyBoss’s storage model. It cannot be resolved in WP Media Cloud without BuddyBoss changing how avatars and cover images are stored.
Private and group-restricted media#
BuddyBoss uses a symlink system to serve private and group-restricted media while enforcing access control through PHP. When files are offloaded and local copies are deleted, BuddyBoss’s symlinks point to non-existent local files and private media breaks.
WP Media Cloud disables BuddyBoss’s symlink system for all media types when it is active, replacing symlink-based delivery with direct CDN URLs returned through WordPress attachment URL functions. This is the same mechanism BuddyBoss built for WP Offload Media compatibility. WP Media Cloud implements the same bypass by hooking the same BuddyBoss filters:
- Symlink creation is disabled for photos, documents, videos, and video thumbnails
- Preview URLs for photos, documents, and video thumbnails are returned as CDN URLs via WordPress attachment functions
- Video file URLs are returned as CDN URLs via WordPress attachment functions
- BuddyBoss is notified that files are being offloaded and delivered by WP Media Cloud
BuddyBoss modules and the Integrations tab#
WP Media Cloud’s Integrations tab shows which BuddyBoss modules are active. The integration reports whether the Media, Document, and Video modules are enabled in BuddyBoss settings. All three are handled by WP Media Cloud when active.
Configuration#
No configuration is required. WP Media Cloud detects BuddyBoss Platform automatically and initialises all integration hooks. The hooks run at PHP_INT_MAX priority to ensure they run after any other plugin modifying the same BuddyBoss filters.
Troubleshooting#
Activity feed photos are not loading from cloud storage
Confirm URL rewriting is enabled in WP Media Cloud > Settings and that the file has been offloaded. Go to Media > Library, find the photo, and check its URL. If it shows the local site URL, run the bulk migration tool. If the URL is correct but the photo is not displaying in the activity feed, confirm BuddyBoss’s Media module is active.
Private or group-restricted media is broken after enabling local file removal
WP Media Cloud disables BuddyBoss’s symlink system and replaces it with CDN URL delivery. If private media is broken, confirm the WP Media Cloud BuddyBoss integration is active by checking the Integrations tab. Also confirm that the file has been offloaded — symlink bypass only helps for offloaded files. Local files that were not offloaded before being deleted cannot be served.
Avatars are not loading from cloud storage
Avatars cannot be offloaded. This is a permanent limitation. Avatars are stored outside the WordPress media library and WP Media Cloud cannot access them. They are always served from your server.
Video thumbnails are not showing
Video thumbnails are WordPress attachments generated by BuddyBoss. Confirm the thumbnail attachment has been offloaded by checking it in the media library. If the thumbnail was generated after the video was uploaded and before WP Media Cloud was configured, run the bulk migration tool to offload it.