How to enable Content Offloading in the bunny.net WordPress plugin

This guide walks you through the steps required to enable CDN acceleration and configure Content Offloading using the bunny.net WordPress Plugin. With Bunny Offloader, your content is automatically transferred to Bunny Storage, enabling multi-region replication, near-unlimited scalability, and up to 5× faster performance compared to traditional delivery methods.

Note: Offloading is only supported when using the official Bunny.net plugin and managing DNS through bunny.net. It is not compatible with third-party plugins or external DNS providers.

What You’ll Need

Before you begin, ensure you have the following:

How It Works

The Offloader feature requires that your domain is using Bunny DNS with CDN Acceleration enabled. Offloading cannot function if your domain is managed by another DNS provider or lacks acceleration.

Step 1: Migrate Your Domain to Bunny DNS

Skip this step if your domain is already using Bunny DNS.

  1. Log in to bunny.net and go to Delivery → DNS → Add DNS Zone
73620571-4dff-472a-b978-85ceeae0a188.png
  1. Enter your domain name and click Add DNS Zone

Important: When creating a DNS zone, it must be based on the root domain (e.g., "domain.com").
Creating a zone for "www.domain.com" or "something.domain.com" is not valid, as these are subdomains of the root domain.

550ea5e5-a32f-44ee-9b9e-dace41939c73.png
  1. Follow the setup instructions, then click Okay, I’m done
0a3a45a0-0261-4eb8-b408-784a6b8f7c72.png
  1. Click Add Record
f254b3b7-1fbe-42a9-967a-1f9f34d140ee.png
  1. Enter the required DNS record details and click Add Record
fa0be6bc-9d7a-4584-9288-628f6c5e1a98.png
  1. Continue adding necessary DNS records based on the setup prompts
870ae067-b244-4e00-8dba-5628699bd191.png

IMPORTANT: When migrating your DNS to bunny.net, make sure to transfer all existing DNS records, not just the website-related ones. Failing to do so can result in critical services (like email) going offline.

  1. Confirm your DNS settings have propagated. Use the bunny DNS Lookup Tool to check. Look for NS records pointing to either kiki.bunny.net or coco.bunny.net.
0d82e208-1b67-49c6-8c4b-a383760b8a36.png

Need help with DNS setup? Refer to the DNS documentation section for detailed instructions.

Step 2 (Conditional): Enable CDN Acceleration in the bunny.net Plugin

Note: If your domain was already using Bunny DNS when you installed the plugin, the “Enable CDN Acceleration” option may not appear.
In that case, go to Step 3 to check if it’s already enabled.
If not, you can reset the plugin to start the configuration from scratch and then continue from Step 3.

  1. In the bunny.net dashboard, go to the DNS section. Click the button in the CDN Proxy (or CDN acceleration) column next to each DNS record.
eea1a4c9-9550-48b5-89b6-1b737e508e46.png
  1. In your WordPress Admin Panel, navigate to bunny.net → Offloader
  2. Follow the on-screen prompts and click Enable CDN Acceleration. You’ll receive an orange confirmation message once configured.
166af086-a6cb-4681-b39c-edf579e72067.png

Important: Enabling CDN acceleration here disconnects your current Pull Zone and creates a new one. Make sure to copy any essential settings (e.g., Edge Rules, Cache settings, Optimizer configurations) from the old zone to the new one. After migration, the old Pull Zone can be safely deleted.

Step 3: Confirm That CDN Acceleration is Working

  1. Return to the bunny.net DNS section. A green CDN Proxy icon next to your DNS record indicates proper CDN integration:
76556f79-e643-4fc3-a4f4-8b124e9a0d57.png
  1. Inspect response headers from your site to verify CDN delivery. Look for headers like:

CDN-ProxyVer: 1.04 

CDN-RequestPullSuccess: True 

CDN-RequestPullCode: 200

  1. In your WordPress Admin Panel, go to bunny.net → About. Under Technical Information, locate the Request Headers section. If you see both Cdn-RequestId and Via: BunnyCDN, everything is working correctly.
d71cbbaa-d8c6-4635-93b2-8864f00309dd.png

Step 4: Enable the Offloader

  1. In your WordPress Admin Panel, navigate to bunny.net → Offloader
  2. Toggle on Content Offloading, adjust settings to your preference, and click Save Settings
c911fd70-550f-4274-bdba-aed44cee1a2b.png

🎉 That’s it! You’ve successfully enabled the Bunny Offloader in your WordPress site. You can now monitor offloaded content through the Offloader dashboard.


💬 Need Help?

If you encounter any issues or need further assistance, our support team is happy to help. Contact us via the support request form for fast, friendly support.

Table of Contents

Was this article helpful?
3 out of 5 found this helpful