Docs

WooCommerce

4 min readUpdated November 9, 2026

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#

WooCommerce card on the Integrations tab
MediaStored asHandling
Product imageAttachment IDServed from the CDN automatically
Product gallery imagesAttachment IDsServed from the CDN automatically
Product category imagesAttachment IDServed from the CDN automatically
Downloadable filesFile URL saved on the productOffloaded; 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#

WooCommerce card in Settings with Secure Downloads
ProviderHow links are signed
Bunny.netToken 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 providerPresigned 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.

  1. Back up your database.
  2. Offload your media first, with Offload All Media on the Dashboard.
  3. Go to Media Cloud > Settings and find the WooCommerce card.
  4. Click Update WooCommerce Download URLs. It runs in batches and shows its progress.
  5. 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).
  6. 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_uploads are in your public bucket like any other media, so anyone with their plain CDN URL can open them. Keep paid files in woocommerce_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#

SymptomCauseFix
Product images load from your siteRewrite URLs is off, or the images are not offloadedTurn on Rewrite URLs, then run Offload All Media
A download link is not signedSecure downloads are off, or the file is not offloadedTick Enable secure downloads; offload the file
A protected product file was not offloadedSecure downloads are off, Bunny.net has no key, or you use Cloudflare R2 or Backblaze B2See WooCommerce secure downloads
A red asterisk on a download file in WooCommerceThe CDN URL is not an approved download directoryAdd and enable it
Bunny.net download returns 403The key is not from the downloads pull zone, or Token Authentication is off on itCopy the key from the downloads pull zone again and save
Images stopped loading on Bunny.netToken Authentication was turned on for the pull zone that serves your imagesTurn 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 serverCheck the storage keys (Health tab) or the Bunny key
Download files disappeared from products and order emailsThe product file list in the database is damaged, often by a plugin or search and replace tool that changes saved product dataRestore a database backup, or open each product and add its files again
Update WooCommerce Download URLs reports damaged file listsThose products’ file lists were already damaged before the tool ran; they were left untouchedOpen each product and add its files again

More checks: WooCommerce downloads not working.

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