Bunny Edge Storage
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 key | Storage zone password | Token Authentication key | |
|---|---|---|---|
| Required? | Yes, for the setup wizard and stats | Yes | No, only for WooCommerce secure downloads |
| Where it lives | Account, then API Key | Your storage zone, Access tab | Your pull zone, Security |
| What the plugin uses it for | Listing your storage zones and pull zones, and Dashboard stats | Uploading, restoring and deleting files | Signing short-lived download links |
| Scope | Full access to your Bunny account | Only that one storage zone | Only 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 freeb-cdn.netaddress.
Step 1: Create a storage zone#
- In the Bunny dashboard, select Storage in the left menu, then Add Storage Zone.
- Enter a name, for example
example-media. - Choose a storage tier. Standard (HDD) lets you pick any region. Edge (SSD) is only available in Frankfurt.
- Choose your main storage region. Pick the one closest to your web server, because that is where uploads go.
- Optionally, add replication regions. Bunny copies each file there after upload. Replication regions cannot be removed later, so choose carefully.
- Leave S3 compatibility off. WP Media Cloud uses Bunny’s own storage API.
- Select Add Storage Zone.
WP Media Cloud works with these main regions:
| Region | Code |
|---|---|
| Frankfurt | de |
| London | uk |
| Stockholm | se |
| New York | ny |
| Los Angeles | la |
| Singapore | sg |
| Sydney | syd |
| Johannesburg | jh |
| Sao Paulo | br |
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.
- Select CDN in the left menu, and create a new pull zone.
- In the pull zone settings, open Origin.
- Set Origin Type to Bunny Storage Zone.
- Choose your storage zone from Step 1.
- Select Save.
The pull zone gets an address like example-media.b-cdn.net.
Optional: Use your own domain#
- Open your pull zone. In the Hostnames panel, enter a subdomain such as
media.example.com. - Select Add hostname, and copy the CNAME value shown.
- At your DNS provider, add a
CNAMErecord formediathat points to that value. On Cloudflare, turn the proxy off (grey cloud). - 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#
- Select Storage and open your storage zone.
- Open the Access tab and select API / HTTP.
- 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#
- In the Bunny dashboard, open Account, then API Key.
- 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#

In WordPress, open Media Cloud in the admin menu. The setup wizard opens on first use. Choose Bunny.net and select Continue.
| Field | What to enter |
|---|---|
| API Key | Your account API key from Step 4. Then select Load Zones. |
| Storage Zone | Choose your zone from the list. The region is set for you. |
| Zone Password | The 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#

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#

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#

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(orwp 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-Controlheader. 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.
- In Bunny, select CDN, open your pull zone, and select Security.
- Turn on Token Authentication, and copy the URL Token Authentication Key.
- In WordPress, go to Media Cloud, then Settings, and find the WooCommerce card.
- Tick Enable secure downloads, and paste the key into Bunny Token Auth Key.
- 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 see | What it means | How to fix it |
|---|---|---|
Could not load storage zones: Bunny API HTTP 401 | The 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 configured | The 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 401 | The 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.php | The 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 404 | The 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 403 | Token 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 error | SSL 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 hostname | The 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 setup | The 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 server | Offload 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 slow | The 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.