WooCommerce downloads not working
Use these checks when a customer cannot download a product file that is stored in the cloud.
How downloads work with WP Media Cloud#
- WP Media Cloud steps in for any product file that is offloaded, whether the product stores its local URL or its CDN URL.
- With Enable secure downloads on, the customer gets a signed link that expires after 10 minutes, with every storage provider and every WooCommerce download method.
- With it off, WooCommerce serves a file from your server while the local copy exists, and from its CDN address once the local copy is removed.
- Protected files in
woocommerce_uploadsare never handed out as a plain CDN address. If one cannot be signed and is no longer on your server, the customer sees “This download is temporarily unavailable. Please contact the store.” - Products can keep their local file URLs. Update WooCommerce Download URLs is optional and not needed for downloads to work.
Check 1: Is the file offloaded?#
- Go to Media > Library, switch to list view, and find the file.
- Offloaded files show In cloud under the file name.
- If not, offload it with the Offload to cloud bulk action. Protected files in
woocommerce_uploadsare only offloaded with secure downloads on (Check 3).
Check 2: Is WooCommerce allowed to use the address?#
- Go to WooCommerce > Settings > Products > Approved download directories.
- If a product stores CDN URLs, confirm your CDN URL is listed and enabled.
http://andhttps://count as different addresses.
Files outside an approved location are disabled until an admin approves them.
Check 3: Is secure downloads set up?#

- In Media Cloud > Settings, in the WooCommerce card, tick Enable secure downloads and click Save Settings.
- Bunny.net: signed downloads need a separate downloads pull zone on the same storage zone, with Token Authentication on. Paste that pull zone’s URL Token Authentication Key into Bunny Token Auth Key, and its address into Downloads Pull Zone URL. Keep Token Authentication off on the pull zone that serves your images. See WooCommerce secure downloads.
- Other providers: no key is needed. Run the checks on the Health tab to confirm your storage keys work.
On Cloudflare R2 and Backblaze B2, protected files in woocommerce_uploads stay on your server, because those buckets cannot keep single files private. Downloads of those files are handled by WooCommerce from your server.
Check 4: Are the product’s files still there?#
Open the product in Products and look at Downloadable files. If the list is empty although files were added before, the product’s file list in the database can no longer be read. A plugin or search and replace tool that changes saved product data without fixing its stored lengths causes this; WooCommerce then shows no files, and they disappear from the customer’s account and order emails.
- Restore a database backup, or add the files to each product again.
- Do not run a search and replace on
_downloadable_files.
Update WooCommerce Download URLs reads each product’s file list back after saving and puts the original back if the saved list cannot be read. Products whose list is already damaged are skipped and reported, never saved over.
Check 5: Test one download#
- Place a test order, or use an existing one.
- Open your browser’s developer tools, go to the Network tab, and click the download link.
- Check where the redirect goes and what status it returns.
| Symptom | Meaning | Fix |
|---|---|---|
| No redirect, the file comes from your site | The file is not offloaded, or it is a protected file kept local | Check 1 and Check 3 |
CDN URL without token= or X-Amz-Signature= | Secure downloads are off | Check 3 |
| 403 on a signed Bunny link | The key is not from the downloads pull zone, Token Authentication is off on it, or the link expired | Copy the key from the downloads pull zone again and save; click the download link again |
| Signed Bunny link goes to your main pull zone | Downloads Pull Zone URL is empty | Enter the downloads pull zone’s address (Check 3) |
| 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 |
| 403 on a presigned link | The storage keys are wrong, the link expired, or the server clock is wrong | Run the Health checks; ask your host to check the server time |
| 403 on a plain CDN URL | The bucket or CDN does not allow public reads | Turn on secure downloads, or allow public reads |
| 404 | The file is not at that path in the bucket | Check 1, then look for the file in your provider’s console |
| “This download is temporarily unavailable” | A protected file could not be signed and is not on your server | Check 3 |
| WooCommerce shows its own error before any redirect | The file is not in an approved location | Check 2 |
| No download link at all in the account or order email | The product’s file list cannot be read | Check 4 |
Signed links last 10 minutes from the click. A customer who waits longer can click the download link again for a new one.
Fixed in earlier versions#
If you see these, update the plugin:
- Before 1.2.0: signed Bunny.net links returned 403 with Token Authentication on, and file names with spaces or accents failed to sign.
- Before 1.2.1: Bunny.net links could only be signed for the main pull zone, so turning on Token Authentication broke your images. 1.2.1 adds Downloads Pull Zone URL.
- Before 1.2.2: Update WooCommerce Download URLs did not check what was saved. It now reads each product’s file list back, restores the original if it cannot be read, and skips products whose list is already damaged.