WooCommerce
WP Media Cloud works with WooCommerce. Product images need no setup. Downloadable files download from the cloud, and with secure downloads on, every download is a signed link that expires after 10 minutes. Secure downloads work with every storage provider.
What the integration does#

| Media | Stored as | Handling |
|---|---|---|
| Product image | Attachment ID | Served from the CDN automatically |
| Product gallery images | Attachment IDs | Served from the CDN automatically |
| Product category images | Attachment ID | Served from the CDN automatically |
| Downloadable files | File URL saved on the product | Offloaded; downloads go to the cloud copy (signed when secure downloads are on) |
Downloadable files work whether the product stores the local URL or the CDN URL. Product files in WooCommerce’s protected woocommerce_uploads folder are only offloaded when secure downloads are on and your storage can keep them private; see WooCommerce secure downloads.
Secure downloads#

| Provider | How links are signed |
|---|---|
| Bunny.net | Token Authentication on a separate downloads pull zone. Enter its key in Bunny Token Auth Key and its address in Downloads Pull Zone URL. |
| Every other provider | Presigned URL on the bucket endpoint, using your saved storage keys. Nothing extra needed. |
- Links expire after 10 minutes. Each click creates a new link.
- All three WooCommerce download methods are signed: Force downloads, X-Accel-Redirect/X-Sendfile and Redirect only.
- Products do not need CDN URLs: local file URLs are recognised and signed too.
The full setup, including the Bunny.net downloads pull zone, is in WooCommerce secure downloads.
Update WooCommerce Download URLs (optional)#
The button in the WooCommerce card (Media Cloud > Settings) rewrites every downloadable product file to its CDN URL, if you prefer products to store that address. With secure downloads on you do not need it: every download is signed when it is clicked, whichever URL the product stores.
- Back up your database.
- Offload your media first, with Offload All Media on the Dashboard.
- Go to Media Cloud > Settings and find the WooCommerce card.
- Click Update WooCommerce Download URLs. It runs in batches and shows its progress.
- Read the result: how many file URLs were updated, and why any were left as they are (already on the CDN, not offloaded yet, not in the Media Library, or a link to another site).
- Go to WooCommerce > Settings > Products > Approved download directories and check your CDN URL is listed and enabled.
It covers simple products, variable products and variations in any status, and recognises http://, www and server-path forms of your uploads URL. Running it again is safe.
Each product’s file list is read back after WooCommerce saves it. If the saved list cannot be read or lost the new URL, the original is put back exactly as it was and the product is reported as not saved. Products whose stored file list is already damaged are skipped and reported, never saved over.
Status on the Integrations page#
The WooCommerce card under Media Cloud > Integrations shows:
- Secure Downloads: Enabled or Disabled
- Token Key: Set or Not set (Bunny.net). Other providers always show Set, since no key is needed.
The status updates on the next page load after WooCommerce is activated.
Limits#
- Regular media stays public. Secure downloads change the link customers get. Files outside
woocommerce_uploadsare in your public bucket like any other media, so anyone with their plain CDN URL can open them. Keep paid files inwoocommerce_uploads(WooCommerce does this when you upload through the product screen). - Changing your CDN URL: Update WooCommerce Download URLs skips URLs on an old CDN hostname. Edit those file URLs on the product.
- Back to local URLs: use the URL Replace tool with CDN URLs back to local. Back up your database first.
Troubleshooting#
| Symptom | Cause | Fix |
|---|---|---|
| Product images load from your site | Rewrite URLs is off, or the images are not offloaded | Turn on Rewrite URLs, then run Offload All Media |
| A download link is not signed | Secure downloads are off, or the file is not offloaded | Tick Enable secure downloads; offload the file |
| A protected product file was not offloaded | Secure downloads are off, Bunny.net has no key, or you use Cloudflare R2 or Backblaze B2 | See WooCommerce secure downloads |
| A red asterisk on a download file in WooCommerce | The CDN URL is not an approved download directory | Add and enable it |
| Bunny.net download returns 403 | The key is not from the downloads pull zone, or Token Authentication is off on it | Copy the key from the downloads pull zone again and save |
| Images stopped loading on Bunny.net | Token Authentication was turned on for the pull zone that serves your images | Turn it off there; use a downloads pull zone |
| “This download is temporarily unavailable” | A protected file could not be signed and is no longer on your server | Check the storage keys (Health tab) or the Bunny key |
| Download files disappeared from products and order emails | The product file list in the database is damaged, often by a plugin or search and replace tool that changes saved product data | Restore a database backup, or open each product and add its files again |
| Update WooCommerce Download URLs reports damaged file lists | Those products’ file lists were already damaged before the tool ran; they were left untouched | Open each product and add its files again |
More checks: WooCommerce downloads not working.