Pricing
  1. Home
  2. Knowledge Base
  3. BuddyBoss Platform Docs
  4. Platform Settings
  5. How to Set Up Cloudflare Media Offloading in BuddyBoss

How to Set Up Cloudflare Media Offloading in BuddyBoss

Introduction

The Cloudflare Media Offloading feature in the BuddyBoss Platform allows you to automatically store and serve your images, videos, and documents through Cloudflare’s CDN and secure storage. This setup improves your site’s performance, enhances video streaming, and reduces server load.

This article explains how to enable and configure Cloudflare Media Offloading, manage your media files, and understand the benefits this feature brings to your BuddyBoss community.

Note: The Activity Post Sharing feature is included with BuddyBoss Platform Plus Plan.

Prerequisites

  • In your WordPress Dashboard, go to BuddyBoss > Integrations > Cloudflare.
  • Make sure you have the BuddyBoss Plus Plan, as this feature is included in that plan.
  • Download and install the BuddyBoss Offload Media plugin from your BuddyBoss account.

Connect BuddyBoss to Your Cloudflare Account

To connect your BuddyBoss site with Cloudflare, you’ll need your Cloudflare Account ID and API Token.

Configure Global Settings

After successfully connecting your Cloudflare account, configure your offloading preferences.

  1. Go to BuddyBoss > Integrations > Cloudflare > Global Settings.

Obtain Cloudflare Account ID

  1. Log in to your Cloudflare Dashboard.
  2. From your account homepage, click the ellipsis (⋯) next to your account name.
Screenshot of the BuddyBoss account home page showing navigation on the left with tabs for Domains Developer Platform and Zero Trust and buttons to onboard or buy a domain
  1. Select Copy Account ID, then paste it into the Account ID field on your BuddyBoss site.
A web dashboard for BuddyBoss is shown with a dropdown menu open under Copy account ID which is highlighted in red Menu options include Members Account API tokens Audit logs Billing and Configurations

Creating Cloudflare Account API Tokens

  1. Click your profile icon in the upper-right corner, then select Profile.
A dashboard for BuddyBoss is displayed with the Profile option highlighted in the top right dropdown menu The left sidebar shows navigation options and domains information is visible in the main panel
  1. Go to the API Tokens tab and click Create Token.
A user interface displays the User API Tokens page API Tokens and Create Token are highlighted The left sidebar shows navigation options and a list of API tokens with their names permissions status and actions is visible
  1. Scroll down and click Get started next to Custom Token.
A website interface shows the API Tokens menu highlighted A list of token templates appears each with a Use template button At the bottom Create Custom Token has a blue Get started button outlined in red
  1. Enter a name for your token (e.g., BuddyBoss Media Token).
A web page shows a form to create a custom API token with a highlighted box around the Token name input field The page includes sections for permissions resources and IP address filtering
  1. Under Permissions, select:

For Global Settings:  Account > Account Settings > Read
For Image Offload: Account > Cloudflare Images > Edit
For Video Offload: Account > Stream > Edit
For Video Offload: Account > Workers R2 Storage > Edit

A screenshot of the Cloudflare User API Tokens page highlighting the Permissions section where users can select and assign account or resource permissions for a custom API token
  1. (Optional) Set an expiration date under TTL if you want the token to expire.
A web interface for configuring API tokens shows fields for account selection IP address filtering and a TTL section to set the tokens active duration with start and end date buttons highlighted
  1. Click Continue to Summary.
  1. Then click Create Token.
A user interface screen showing the creation of a user API token with the Create Token button highlighted in blue Menu options appear on the left and instructions are displayed in the main section
  1. Copy your new token API Token.
A web page displaying the User API Tokens section showing a successfully created API token a blurred token field instructions for testing the token and navigation options on the left sidebar

Linking your Cloudflare Account

  1. Go to BuddyBoss dashboard > Integration > Cloudflare.
  2. Input your Cloudflare Account ID and Account API token.
A BuddyBoss settings page displays fields for Account ID and Account API Token both highlighted with red boxes The sidebar menu shows integration options The screens background features rounded color shapes
  1. Click Verify.
A website dashboard displays the BuddyBoss integrations settings page showing fields for Account ID and Account API Token with a Verify button highlighted in red below the token field

Once verified, you will see a verification message:

A dialog box on a website displays a green checkmark with the message Account ID verification was successful and an Ok button indicating a completed verification process

Set Up Media Offloading

  1. Enable Remove Local Media if you want BuddyBoss to automatically delete media from your server after it’s uploaded to Cloudflare.
A settings page in the BuddyBoss WordPress dashboard displaying Cloudflare integration options The Remove media from server after uploading to Cloudflare checkbox is highlighted in red The left sidebar menu is visible
  1. Under Browser TTL, select how long files should stay cached in browsers options range from 2 days to 1 year.
A BuddyBoss dashboard shows the Cloudflare integrations settings with the Browse TTL field highlighted and set to 2 days The interface features a white background and colored shapes in the corners
  1. Choose the media types you want to offload

.

  1. Click Save Settings to apply your configuration.

Set Up Media Offloading

  1. Go to Cloudflare dashboard > Media > Images > Hosted Images > key tab.
A dashboard shows the Hosted images section of an image management platform The Keys tab is selected displaying an API token named default Menu items on the left are highlighted in red boxes
  1. Copy the default API Token. This is your Signed Token.
  2. Navigate to BuddyBoss > Integrations > Cloudflare > Image Configuration section.
  3. Enter your Key Token, and Signed Token to securely connect your site to Cloudflare.

Note: Your Key Token is the same as your Account API token

  1. Click Verify. A verified message will appear if successful.
A pop up window displays a message with a green checkmark Image configuration verification was successful An Ok button appears at the bottom right of the pop up
  1. Enable Custom Domain If you want to use your own domain for serving media.
Screenshot of a WordPress admin settings page showing the Image Configuration section with the Custom Domain option outlined in red The menu on the left lists site management options
  1. Activate Offload non-compliant images to R2 if you want to store Images that don’t meet the rules as documents in Cloudflare R2.
Screenshot of a WordPress plugin settings page highlighting the Image Configuration section with an option to offload non compliant images to Cloudflare R2 and details about image limits and formats
  1. Click Save Settings once all options are configured. 

Deleted files will also be removed from Cloudflare, ensuring both systems stay synchronized.

Configure Video Integration with Cloudflare Stream

The Video Configuration section allows you to connect Cloudflare Stream to BuddyBoss Media so videos are hosted and served securely from Cloudflare’s fast, global CDN improving load times and reducing server usage.

Follow these steps to set it up:

Setup Video offload Configuration 

  1. Navigate to BuddyBoss > Integration > Cloudflare.
  2. Scroll down to find the Video Configuration panel.
  3. Input your Stream API Key.
A screenshot of a website settings page shows the Video Configuration section with a highlighted field labeled Stream API Token outlined in red Other configuration sections are visible above and below

Note: Your Key Token is the same as your Account API token

  1. Click Verify. A verified message will appear if successful.
A dialog box with a green checkmark displays the message Video configuration verification was successful and an Ok button on a partially visible web page background
  1. If you want videos to stream under your own domain (for example, videos.yourdomain.com instead of a Cloudflare URL), check the box labeled Serve from the custom domain.
  2. Check the box for Offload non-compliant videos to R2 so that unsupported or large videos are stored as Cloudflare R2 documents instead of Stream videos.

 Document Configuration

  1. From your WordPress Dashboard, go to BuddyBoss > Media > Cloudflare.
  2. Go to the Document Configuration (R2) section.

Obtain Your Cloudflare R2 Access Details

To connect BuddyBoss with Cloudflare R2, you’ll need credentials from your Cloudflare account.

  1. Log in to your Cloudflare Dashboard.
  2. Navigate to your Storage and Databases > R2 Object storage > Overview.
  3. In the right part of the website, click Manage.
A dashboard for R2 object storage shows buckets usage stats and account details The Storage databases and R2 object storage menus are highlighted as well as the Manage option under Account Details
image
  1. Click create User API Token.
A web dashboard displays a table of User API Tokens with columns for Token Applied To Permission Issued On and Status A blue Create User API Token button is highlighted on the upper right
  1. Input the name of your API Token, and set the permission to admin read and write.
A web interface for creating a user API token shows fields for the token name and permissions The Token name is set to R2 User Token and several permission options are listed below
  1. Click Create User API Token.
  2. Copy the Access Key ID and Secret Access Key.
A dashboard shows the creation of a Cloudflare API token with permissions summary at the top and red boxes highlighting Access Key ID and Secret Access Key fields below The sidebar menu is visible on the left
  1. Return to your BuddyBoss > Media > Cloudflare Integration page.
  2. Enter your Access Key ID and Secret Access Key
  3. Click Verify to confirm your connection. A verified message will appear if successful.
A pop up window displays the message Verify Document Configuration Document configuration verification was successful with a green check mark icon and an Ok button at the bottom right
  1. (Optional) Select your private or public bucket. If none is selected, the files will be stored in your local server.
A WordPress admin settings page showing Document Configuration options The Public Bucket dropdown is set to Select Bucket and the Private Bucket is set to tutorial site both fields are highlighted with red boxes

Use Bulk Management Tools

Once your Cloudflare R2 integration is active, BuddyBoss provides Bulk Management Tools to help you manage existing and new media efficiently.

Screenshot of a Bulk Management Tools dashboard with options to offload media download files from a bucket delete files from a bucket and delete files from the server A sidebar menu is visible on the left

Available Options:

  • Offload All Media
     Moves your existing media to Cloudflare storage and serves them via Cloudflare’s CDN.
    Click Start Offloading to begin transferring files.
  • Download All Files Bucket to Server
     If you’ve previously removed local media, this lets you re-download all missing files back to your WordPress server.
    Click Download Files to begin.
  • Delete All Files from Bucket
     Permanently deletes all media files stored in your Cloudflare bucket.
    Click Delete All Bucket Files with caution.
  • Delete All Files from Server
     Deletes all local media files that have already been offloaded to Cloudflare.
    Click Delete All Local Files to free up space on your hosting server.

Note: Always check your offload status and backups before deleting files.

Troubleshooting and FAQs

Q: Where can I find my Cloudflare Account ID?
A: Log in to your Cloudflare Dashboard, click the ellipsis (⋯) next to your account name, and select Copy Account ID. Then paste it into the Account ID field on your BuddyBoss site.

Q: How do I create a Cloudflare API Token for BuddyBoss?
A: In Cloudflare, go to your profile, open API Tokens, and click Create Token. Under Permissions, select:

  • Account > Account Settings > Read
  • Account > Cloudflare Images > Edit
  • Account > Stream > Edit
  • Account > Workers R2 Storage > Edit
    Then click Create Token and copy it to your BuddyBoss settings.

Q: How do I verify my Cloudflare connection?
A: After entering your Account ID and API Token, click Verify. A verified message will appear if successful.

Q: Where do I get the Signed Token for image offloading?
A: Go to your Cloudflare Dashboard > Media > Images > Hosted Images > Key tab, then copy the default API Token. This is your Signed Token.

Was this article helpful?
Yes No

Related Articles

Subscribe to Our Newsletter

Stay In Touch

Subscribe to our Newsletter, and we’ll send you the latest news from BuddyBoss

  • This field is hidden when viewing the form
  • This field is for validation purposes and should be left unchanged.

Platform

Company

Compare

See All Comparisons

Use Cases

See All Use Cases

Resources

Agency

  • Group 139Created with Sketch. © All rights reserved, BUDDYBOSS LLC 2025

To speak to our Agency consultant, fill in the form found at our Contact Page.

Get Started
  • Get Started

    Enter your name and email address to get started with your project...

  • This field is for validation purposes and should be left unchanged.
We respect your privacy.