Docs

Bunny Edge Storage

10 min readUpdated November 9, 2026

Bunny Storage is bunny.net’s file storage, served through Bunny’s CDN. WP Media Cloud uploads your Media Library to a Bunny storage zone using Bunny’s own storage API, not S3. Visitors get every file from a pull zone linked to that storage zone, either a b-cdn.net address or your own domain.

This guide takes about 10 minutes.

How Bunny access works#

Bunny uses separate keys for the account and for each storage zone. WP Media Cloud asks for both in the setup wizard.

Account API keyStorage zone passwordToken Authentication key
Required?Yes, for the setup wizard and statsYesNo, only for WooCommerce secure downloads
Where it livesAccount, then API KeyYour storage zone, Access tabYour pull zone, Security
What the plugin uses it forListing your storage zones and pull zones, and Dashboard statsUploading, restoring and deleting filesSigning short-lived download links
ScopeFull access to your Bunny accountOnly that one storage zoneOnly that one pull zone

The storage zone password is not the same as the account API key. Pasting one in place of the other is the most common setup mistake.

Bunny does not offer a read-only account key. The API key is stored in your WordPress database, or in wp-config.php if you use constants. Treat it like a password.

Before you start#

  • A bunny.net account.
  • A domain you control (optional). To use your own address, such as media.example.com, you add a CNAME record at your DNS provider. Without one, you use the free b-cdn.net address.

Step 1: Create a storage zone#

  1. In the Bunny dashboard, select Storage in the left menu, then Add Storage Zone.
  2. Enter a name, for example example-media.
  3. Choose a storage tier. Standard (HDD) lets you pick any region. Edge (SSD) is only available in Frankfurt.
  4. Choose your main storage region. Pick the one closest to your web server, because that is where uploads go.
  5. Optionally, add replication regions. Bunny copies each file there after upload. Replication regions cannot be removed later, so choose carefully.
  6. Leave S3 compatibility off. WP Media Cloud uses Bunny’s own storage API.
  7. Select Add Storage Zone.

WP Media Cloud works with these main regions:

RegionCode
Frankfurtde
Londonuk
Stockholmse
New Yorkny
Los Angelesla
Singaporesg
Sydneysyd
Johannesburgjh
Sao Paulobr

Step 2: Create a pull zone#

A pull zone is the CDN address visitors load your files from. WP Media Cloud needs one. It will not offload anything until a pull zone is set.

  1. Select CDN in the left menu, and create a new pull zone.
  2. In the pull zone settings, open Origin.
  3. Set Origin Type to Bunny Storage Zone.
  4. Choose your storage zone from Step 1.
  5. Select Save.

The pull zone gets an address like example-media.b-cdn.net.

Optional: Use your own domain#

  1. Open your pull zone. In the Hostnames panel, enter a subdomain such as media.example.com.
  2. Select Add hostname, and copy the CNAME value shown.
  3. At your DNS provider, add a CNAME record for media that points to that value. On Cloudflare, turn the proxy off (grey cloud).
  4. Back in Bunny, select Verify & Activate SSL for a free certificate.

When WP Media Cloud loads your pull zones, it uses your own hostname if one is linked, and the b-cdn.net address otherwise.

Step 3: Copy the storage zone password#

  1. Select Storage and open your storage zone.
  2. Open the Access tab and select API / HTTP.
  3. Copy the Password into a password manager.

The same page shows the storage zone name and its API endpoint. You do not need the endpoint, because WP Media Cloud picks it from the zone’s region.

Step 4: Copy your account API key#

  1. In the Bunny dashboard, open Account, then API Key.
  2. Select the eye icon to show the key, or the copy icon to copy it.

Do not select the refresh icon. It generates a new key, and you must then update every tool that uses the old one.

Step 5: Connect WP Media Cloud#

Setup wizard Connect step for Bunny.net

In WordPress, open Media Cloud in the admin menu. The setup wizard opens on first use. Choose Bunny.net and select Continue.

FieldWhat to enter
API KeyYour account API key from Step 4. Then select Load Zones.
Storage ZoneChoose your zone from the list. The region is set for you.
Zone PasswordThe storage zone password from Step 3
Pull Zone (CDN)Choose the pull zone from Step 2. The list only shows pull zones linked to this storage zone.

Select Continue, then Save & Go to Dashboard.

Check that it works#

Health tab after Run All Checks

Open the Health page and select Run All Checks. For Bunny, the API check lists your storage zones. The Upload check uploads a tiny test file to your zone and deletes it again. When you see Test file uploaded and deleted successfully., you are connected.

Changing your zones or keys later#

Bunny.net card in Settings

Go to Settings and select run the setup wizard. In WP Media Cloud 1.1.8 or newer, the wizard opens with your current values filled in. Saved keys show as Saved, so you only paste the ones you are changing. To pick a different storage zone or pull zone, select Load Zones again. Your offloaded files, records and other settings are kept.

Alternative: Connect with wp-config.php#

wp-config.php constants for Bunny.net from the setup wizard

Instead of the wizard, you can define your settings in wp-config.php, above the line /* That's all, stop editing! */. Values set here override anything saved in the admin, which suits sites managed in version control.

Multisite: constants in wp-config.php apply to every subsite, so they point every subsite at the same storage zone. That works when each subsite keeps its files in its own folder: also add define( 'WPMC_PATH_PREFIX', 'sites/%site_id%' );. Or set up each subsite in its own dashboard. See Custom path prefix.

// Required
define( 'WPMC_PROVIDER',                 'bunny' );
define( 'WPMC_BUNNY_STORAGE_ZONE',       'example-media' );
define( 'WPMC_BUNNY_STORAGE_PASSWORD',   'your-storage-zone-password' );
define( 'WPMC_BUNNY_STORAGE_REGION',     'de' ); // de | uk | se | ny | la | sg | syd | jh | br
define( 'WPMC_BUNNY_PULL_ZONE_HOSTNAME', 'example-media.b-cdn.net' ); // hostname only, no https://

// Optional: needed for Dashboard stats and for loading zones in Settings
define( 'WPMC_BUNNY_API_KEY',            'your-account-api-key' );
define( 'WPMC_BUNNY_PULL_ZONE_ID',       '123456' );

The region must match your storage zone’s main region. If you leave it out, the plugin uses de (Frankfurt). You can leave out the pull zone ID. The Dashboard looks it up from the hostname when it can.

The Health page and the Dashboard read these constants too. Dashboard stats also need the storage zone’s ID, which has no constant. To save it, open the setup wizard once, select Load Zones and choose your zone.

After setup#

  • New uploads go to your storage zone automatically and are served from your pull zone.
  • Existing media is not moved until you start a bulk offload. On the Dashboard, find the Bulk Offload card and select Offload All Media. On large libraries or multisite, wp wpmc offload (or wp wpmc offload --network) is faster.
  • Changing your CDN hostname later, for example after adding your own domain: in Settings, open the Bunny.net CDN card. Select Refresh, choose the pull zone, and select Save Settings. Then, under Apply to Existing Media, select Update all media URLs so existing files use the new address.
  • Caching: WP Media Cloud uploads every file with a one-year Cache-Control header. Replaced files get a new file name, so this is safe. How long Bunny’s edge keeps files is set in your pull zone’s caching settings.
  • Dashboard stats: Bunny gives the most detail of any provider. You see storage used, file count, CDN bandwidth for the last 7, 14 or 30 days, cache hit rate, requests and storage growth. Stats need the API key and a pull zone, and are cached for 15 minutes. Storage figures can lag by about a day.
  • WooCommerce secure downloads are supported. See the next section.

WooCommerce secure downloads#

With this on, downloadable product files are delivered through signed links that expire after 10 minutes. Customers cannot share a working link.

  1. In Bunny, select CDN, open your pull zone, and select Security.
  2. Turn on Token Authentication, and copy the URL Token Authentication Key.
  3. In WordPress, go to Media Cloud, then Settings, and find the WooCommerce card.
  4. Tick Enable secure downloads, and paste the key into Bunny Token Auth Key.
  5. Select Save Settings.

Check it with a real order. After you turn it on, place a test order for a downloadable product. The download link in the order email should open, and stop working after 10 minutes.

Troubleshooting#

What you seeWhat it meansHow to fix it
Could not load storage zones: Bunny API HTTP 401The account API key is wrong. Often the storage zone password was pasted instead.Copy the key from Account, then API Key (Step 4).
No storage zones found. Create a Storage Zone in your Bunny dashboard first, then try again.The account has no storage zones yet.Complete Step 1, then select Load Zones again.
No pull zones linked to this storage zone.No pull zone uses this storage zone as its origin.Complete Step 2, then choose the storage zone again so the list reloads.
Media Library shows Not configuredThe storage zone name, password or pull zone hostname is missing. A pull zone is required.Run the setup wizard again, or check your wp-config.php constants.
Offload failed or the Upload health check fails with Bunny Storage HTTP 401The storage zone password is wrong. Often the account API key was pasted instead.Copy the password from the zone’s Access tab (Step 3). If you changed it in Bunny, paste the new one.
Bunny Storage HTTP 401 or 404 when using wp-config.phpThe zone name or region does not match the storage zone.Copy the zone name exactly. Set WPMC_BUNNY_STORAGE_REGION to the zone’s main region.
Uploads work, but file URLs return 404The pull zone’s origin is not this storage zone.In the pull zone’s Origin settings, set Origin Type to Bunny Storage Zone and choose the right zone.
Download links for products return 403Token Authentication key saved in WordPress does not match the pull zone’s key.Copy the URL Token Authentication Key from the pull zone’s Security settings into Bunny Token Auth Key again, and save.
Your own domain shows a certificate errorSSL is not active on that hostname yet, or Cloudflare is proxying it.Select Verify & Activate SSL in the pull zone. On Cloudflare, set the record to DNS only.
Dashboard says No pull zone saved.The pull zone ID is not saved, so bandwidth cannot be looked up.In Settings, open Bunny.net CDN, select Refresh, choose your pull zone and select Save Settings.
Dashboard says Pull Zone ID not found for your hostnameThe saved hostname does not match any pull zone linked to the storage zone.Same fix: Refresh in the Bunny.net CDN card, choose the pull zone, and save.
Dashboard shows no stats on a wp-config.php setupThe API key or storage zone ID is missing.Add WPMC_BUNNY_API_KEY. Then open the setup wizard once, select Load Zones and choose your zone.
New uploads stay on your serverOffload on upload is switched off. Before 1.1.7.1, finishing the setup wizard could switch it off.In Settings, turn on Offload on upload and Rewrite URLs, then select Save Settings.
The first load of an image is slowThe CDN has not cached it yet.Nothing to fix. Later requests come from Bunny’s edge cache.

Frequently asked questions#

Why does the plugin need my account API key? It lists your storage zones and pull zones so you can pick them, and it reads usage for the Dashboard. Uploads use only the storage zone password.

Do I need replication regions? No. They add copies of your files in other regions. Remember that you cannot remove them later.

Do I need to turn on S3 compatibility? No. WP Media Cloud uses Bunny’s own storage API with the storage zone password.

Can I use one storage zone for several sites? Yes, when each site has its own path prefix. WP Media Cloud stores files by upload date and file name, such as 2026/10/photo.jpg, so two sites without a prefix can overwrite each other’s files. On a multisite network, set Path prefix to sites/%site_id%. For separate sites, give each one a prefix of its own, such as shop and blog. A staging site should still use its own storage zone. See Custom path prefix.

Can I use Bunny CDN with a different storage provider? Yes. For providers such as Google Cloud Storage or Amazon S3, choose Bunny.net CDN under CDN Configuration in the setup wizard.

WP Media Cloud never offloads font files while Serve fonts from your site is on (the default), so fonts need no CORS rule on your pull zone. See Serve fonts from your site.

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