Eren Labs JOURNAL TR
WooCommerce Errors

“The downloadable file cannot be used” in WooCommerce: approved directories, file types and disabled files

WooCommerce checks every new or changed downloadable file before it saves the product. Here is what each of the three refusals means, why shop managers hit them more often than administrators, and where the setting behind them lives.

In this article13 sections

WooCommerce keeps a list of approved download directories: folders and web addresses that downloadable products are allowed to serve files from. When you add or change a file on a product, WooCommerce checks it against that list and a few other rules. If it fails, the file isn’t saved and you get one of these messages.

The rule exists so that someone who can edit products can’t point a download at any file on the server. It’s also why the same file can work for an administrator and fail for a shop manager.

The exact message#

The downloadable file https://files.example.net/books/guide.pdf cannot be used as it does not exist on the server, or is not located within an approved directory. Please contact a site administrator for help. Learn more.

The same failure can also read:

  • The downloadable file guide.epub cannot be used as it does not have an allowed file type. Allowed types include: jpg|jpeg|jpe, gif, png, bmp, tiff|tif, webp, avif, …
  • The downloadable file guide.pdf cannot be used as it has been disabled.
  • The indicated downloads have been disabled (invalid location or filetype—learn more).

Who sees it: Store owners and shop managers, as a notice at the top of the product editor after Update or Publish (or in the Variations tab after Save changes). The REST API returns the same text as error code product_invalid_download, and the CSV importer lists the row as failed. The last wording is a note under the Downloadable files table that marks files WooCommerce has already disabled.

What WooCommerce checks#

Each time the product is saved, WooCommerce checks every file, in this order. It shows an error only for files that are new or have a changed URL:

  1. Disabled. A file already marked as disabled is refused with …has been disabled.
  2. File type. Files on your own site, whether given as a path or as a URL on your domain, must have a type WordPress lets you upload. Files on other domains skip this test.
  3. Exists. A file path, as opposed to a URL, must point at a file that exists.
  4. Approved directory. While the rules are enforced, the file must sit inside a folder that is an enabled rule. If it doesn’t, WooCommerce adds its folder to the list by itself: enabled when you are a site administrator, disabled when you are not. A disabled rule doesn’t count, so the file is refused.

If more than one file fails, only the first message is shown. A failing new file is dropped. A file that was already on the product and fails is kept but disabled, and it is marked with an asterisk and the note The indicated downloads have been disabled under the Downloadable files table. Customers don’t see disabled files in their downloads.

The list lives at WooCommerce > Settings > Products > Approved download directories, next to Downloadable products. Only site administrators can see that screen.

Causes and how to fix each one#

1. A shop manager added a file from a new folder#

When the file’s folder isn’t on the list, WooCommerce adds it, but only enables it for a site administrator. For a shop manager the new rule is created disabled, so the file is refused, and the shop manager can’t open the screen to enable it.

Check: As an administrator, open WooCommerce > Settings > Products > Approved download directories and look for the file’s folder with Enabled showing a dash.

Fix: If the folder is trustworthy, an administrator enables the rule (hover the row and click Enable), then the shop manager saves the product again.

2. The folder’s rule exists but is disabled#

This one affects administrators too. WooCommerce only adds a rule when none exists for that folder. If a disabled rule is already there, it isn’t switched on, and the file is refused. Disabled rules come from a shop manager’s earlier attempt, from someone switching a rule off, or from the time WooCommerce set the list up on a store that already had downloads: it listed the folders those products used as disabled rules for review.

Check: Find the folder on the Approved download directories screen. Rules match the start of the file’s address, so http and https, or www and no www, are different folders.

Fix: Enable the rule, or add a new rule with Add New for the exact address the files use.

3. The file path doesn’t exist#

The “does not exist on the server” half of the message only applies to file paths such as wp-content/uploads/woocommerce_uploads/guide.pdf or /home/shop/files/guide.pdf. WooCommerce doesn’t check that a URL exists. Paths break after a move to a new host, or when the file was renamed or never uploaded.

Check: If the File URL field holds a path rather than an https:// address, confirm the file is at that exact location on the server.

Fix: Upload the file with the Choose file button, which stores it in the woocommerce_uploads folder that is approved by default, or correct the path.

4. The file type isn’t allowed#

A file on your own site must have one of the types WordPress allows for uploads, and the message lists them. Some common download formats aren’t in WordPress’s default list, such as .epub, .mobi and .svg. .exe is never allowed, and .html and .js only for users with the unfiltered_html capability. Files hosted on another domain are not type-checked.

Check: Look at the file’s extension and look for it in the list printed in the message.

Fix: Put the file in a .zip, which is allowed, or have a developer add the type with the filter shown below.

5. The file had already been disabled#

WooCommerce disables a file that is on a product but fails the checks, for example after its folder’s rule was switched off. The has been disabled wording appears when such a disabled file is handed back to WooCommerce as a new or changed file, which happens when code copies downloads from one product to another rather than when you type in the editor.

Check: Open the product the file came from. A disabled file is marked with an asterisk under Downloadable files.

Fix: Fix the reason it was disabled (usually by enabling its folder’s rule), then add the file again on the new product.

Quick reference#

CauseHow to checkFix
A shop manager added a file from a new folderAs an administrator, open WooCommerce > Settings > Products > Approved download directories and look for the file's folder with Enabled showing a dash.If the folder is trustworthy, an administrator enables the rule (hover the row and click Enable), then the shop manager saves the product again.
The folder's rule exists but is disabledFind the folder on the Approved download directories screen. Rules match the start of the file's address, so http and https, or www and no www, are different folders.Enable the rule, or add a new rule with Add New for the exact address the files use.
The file path doesn't existIf the File URL field holds a path rather than an https:// address, confirm the file is at that exact location on the server.Upload the file with the Choose file button, which stores it in the woocommerce_uploads folder that is approved by default, or correct the path.
The file type isn't allowedLook at the file's extension and look for it in the list printed in the message.Put the file in a .zip, which is allowed, or have a developer add the type with the filter shown below.
The file had already been disabledOpen the product the file came from. A disabled file is marked with an asterisk under Downloadable files.Fix the reason it was disabled (usually by enabling its folder's rule), then add the file again on the new product.

Reproduced on a test store#

We set up each case below on a clean WooCommerce 11.2.1 store on 6 November 2026 and recorded exactly what it showed.

What we didWhat WooCommerce showed
Approved download directories enforced (the screen shows Stop Enforcing Rules). Log in as a Shop manager. On a downloadable simple product, add a file with URL https://files.example.net/books/guide.pdf, a folder with no rule. Press Update.The downloadable file https://files.example.net/books/guide.pdf cannot be used as it does not exist on the server, or is not located within an approved directory. Please contact a site administrator for help. Learn more.
Approved directories now list https://files.example.net/books/ as disabled.
Same as above, logged in as an administrator, with a different folder https://files.example.net/music/track.zip.No message. The change was saved.
Approved directories now list https://files.example.net/music/ as enabled.
As an administrator, disable the rule for https://files.example.net/books/ on WooCommerce > Settings > Products > Approved download directories. Add https://files.example.net/books/other.pdf to another product and press Update.The downloadable file https://files.example.net/books/other.pdf cannot be used as it does not exist on the server, or is not located within an approved directory. Please contact a site administrator for help. Learn more.
Approved directories now list https://files.example.net/books/ as disabled.
As an administrator, add the file path wp-content/uploads/woocommerce_uploads/missing.pdf (no such file) and press Update.The downloadable file wp-content/uploads/woocommerce_uploads/missing.pdf cannot be used as it does not exist on the server, or is not located within an approved directory. Please contact a site administrator for help. Learn more.
Copy guide.epub into wp-content/uploads/woocommerce_uploads/ by FTP. Add https://<your site>/wp-content/uploads/woocommerce_uploads/guide.epub to a product and press Update.The downloadable file guide.epub cannot be used as it does not have an allowed file type. Allowed types include: jpg|jpeg|jpe, gif, png, bmp, tiff|tif, webp, avif, ico, heic, heif, heics, heifs, asf|asx, wmv, wmx, wm, avi, divx, flv, mov|qt, mpeg|mpg|mpe, mp4|m4v, ogv, webm, mkv, 3gp|3gpp, 3g2|3gp2, txt|asc|c|cc|h|srt, csv, tsv, ics, rtx, css, htm|html, vtt, dfxp, mp3|m4a|m4b, aac, ra|ram, wav|x-wav, ogg|oga, flac, mid|midi, wma, wax, mka, rtf, js, pdf, class, tar, zip, gz|gzip, rar, 7z, psd, xcf, doc, pot|pps|ppt, wri, xla|xls|xlt|xlw, mdb, mpp, docx, docm, dotx, dotm, xlsx, xlsm, xlsb, xltx, xltm, xlam, pptx, pptm, ppsx, ppsm, potx, potm, ppam, sldx, sldm, onetoc|onetoc2|onetmp|onepkg, oxps, xps, odt, odp, ods, odg, odc, odb, odf, wp|wpd, key, numbers, pages
Press Stop Enforcing Rules, then repeat shop-manager-new-folder.No message. The change was saved.

For developers#

All three messages are thrown by WC_Product_Download::check_is_valid() and reach the caller as a WC_Data_Exception with code product_invalid_download. To allow an extra file type for downloads only:

add_filter( 'woocommerce_downloadable_file_allowed_mime_types', function ( $types ) {
	$types['epub'] = 'application/epub+zip';
	return $types;
} );

Other hooks in the same path: woocommerce_downloadable_file_exists overrides the existence test for paths, and woocommerce_product_downloads_approved_directory_validation_for_shortcodes controls whether shortcode downloads are run through the approved directory check.

Where this lives in WooCommerce 11.2.1:

  • includes/class-wc-product-download.php, WC_Product_Download::check_is_valid: Disabled first, then file type, then existence of a local path, then the approved directory check.
  • includes/class-wc-product-download.php, WC_Product_Download::approved_directory_checks: Adds the file’s folder as a new rule automatically, enabled only when the current user is a site administrator.
  • includes/class-wc-product-download.php, WC_Product_Download::is_allowed_filetype: Only files on your own site are type-checked, against get_allowed_mime_types() and the woocommerce_downloadable_file_allowed_mime_types filter.
  • includes/abstracts/abstract-wc-product.php, WC_Product::set_downloads: Reports the first error for new or changed files only, drops a failing new file, and disables a failing existing one.
  • src/Internal/ProductDownloads/ApprovedDirectories/Register.php, Register::is_valid_path: A file is approved only if one of its parent URLs is an enabled rule, and only while the rules are enforced.
  • src/Internal/ProductDownloads/ApprovedDirectories/Admin/UI.php, UI::init_hooks: The Approved download directories screen is only added for site administrators.

Back to the WooCommerce error reference.

Frequently asked questions#


Why can I add the file but my shop manager can't?

When a file’s folder isn’t approved yet, WooCommerce approves it automatically for site administrators only. For anyone else the folder is added to the list as disabled, and an administrator has to enable it.


Where is the approved directories list?

WooCommerce > Settings > Products > Approved download directories. The screen only appears for site administrators.


The file opens in my browser. Why does WooCommerce say it doesn't exist?

For a URL, WooCommerce never checks that the file exists. The message means the folder isn’t an enabled approved directory.


Do customers lose access when a file is disabled?

Yes. Disabled files are left out of the customer’s downloads until the file passes the checks again.


Can I switch the check off?

Yes, with Stop Enforcing Rules on the Approved download directories screen. Anyone who can edit products can then link any file, so enabling the right folders is the safer fix.


Which file types are allowed?

The types WordPress allows you to upload, which the message lists. Files hosted on another domain skip the type check.


More in WooCommerce Errors

Keep exploring

All articles