Your Cart
WooCommerce approved download directories

How to Control WooCommerce Approved Download Directories for Safer Digital Delivery

Digital products need more than a product page and a file URL. In a WooCommerce store, the location saved for a downloadable file, the way WooCommerce delivers that file and the configuration of the web server can all affect how access works. This becomes especially important when several people create or edit products, or when files are hosted outside the usual WordPress uploads location.

WooCommerce Approved Download Directories provide administrator-managed rules for the URL-based locations that downloadable product files may use. They can help store owners review and limit file locations, but they are not a complete access-control or digital rights management system. This guide explains the default storage context, the administrator workflow, common reasons paid files become publicly accessible, delivery-method considerations, cloud-hosted files and a controlled troubleshooting process.

What WooCommerce Approved Download Directories Control

Approved Download Directories are URL-based rules that define which locations may be used for downloadable product files. WooCommerce introduced this feature in version 6.5. It is particularly relevant to stores where multiple users create or edit products, because an administrator controls the list of locations that may be referenced.

The feature helps establish a defined set of approved locations rather than allowing every product editor to use an arbitrary file path. Only site administrators, or network administrators in a multisite installation, can modify the approved-directory list. Other users cannot add downloadable files from locations that lack a corresponding approved rule.

The difference between a directory rule and a media-library URL

Directory rules concern locations referenced by downloadable products. They do not govern the WordPress media library generally. This distinction matters because a file uploaded to the public media library may remain reachable through its direct URL, even when the store owner is treating the product as a paid download.

Therefore, an approved directory should be viewed as a location-management control. It does not automatically secure every file stored in that location, prevent link sharing or replace the selected WooCommerce download method and relevant server configuration.

Review the Default Download Storage Location

WooCommerce normally creates a woocommerce_uploads directory inside the WordPress uploads directory and includes it as an enabled approved directory by default. This gives store owners a default storage context when they add downloadable files through WooCommerce.

Approved directory entries are expressed as URLs. When reviewing a rule, check the complete saved URL, including its protocol. Protocol differences matter, and a rule should not be assumed to cover a location merely because the domain or path appears similar. A parent approved directory also covers its subdirectories, which can reduce the number of separate rules needed for related file locations.

When a custom or external location needs review

Custom and cloud-hosted locations should be assessed together with the delivery method. An external file URL must comply with an enabled approved-directory rule, and it must work with the way WooCommerce is configured to deliver the download. The relevant question is not only whether the location is listed, but also whether the complete customer download flow behaves as expected.

Location ownership and administrator control are useful configuration considerations, but approval alone is not a universal security guarantee. External services can have their own URL and delivery limitations, so they should be tested before being used for a paid digital product.

How to Approve, Disable and Synchronize Directory Rules

Administrators manage approved download directories under WooCommerce > Settings > Products > Approved Download Directories. From there, they can add, edit or remove directory entries. The settings also allow administrators to enable or disable enforcement globally, enable or disable individual rules and use bulk actions for multiple entries.

These permissions are intentionally limited. Only site administrators can change the approved-directory list, while network administrators perform this task in multisite. A product editor may be able to create or edit a product without being able to expand the locations that the store accepts.

WooCommerce also provides a synchronization tool under WooCommerce > Status > Tools. Synchronize approved download directories scans the product catalog and identifies download paths that are not covered by existing rules. Paths discovered by synchronization are added as disabled rules initially. They must be reviewed before an administrator enables them.

A practical review sequence

  1. Check the current approved-directory list before changing products or storage.
  2. Confirm the exact URL and protocol for each location.
  3. Review whether enforcement is enabled globally and whether the relevant individual rule is enabled.
  4. Use bulk actions carefully when several locations need the same administrative change.
  5. After catalog imports or changes made outside the official importer, run synchronization and inspect every newly discovered disabled rule.
  6. Before disabling or deleting a rule, identify existing products that use the location.

Disabling or deleting a rule can disable affected downloadable files. Customers who already purchased a product may lose access until an administrator restores or corrects the relevant rule. For that reason, synchronization and rule changes should be treated as catalog-impacting operations rather than as isolated settings changes.

Why Paid Downloads Can Become Public

A downloadable file may be accessible to a non-paying visitor for reasons that are separate from whether its location appears in the approved-directory list. One documented cause is adding the file through the public WordPress media library. Media-library files can be reachable through their direct URLs, so a visitor who obtains that URL may not need to complete the WooCommerce purchase flow.

Another cause is selecting Redirect only (insecure) as the download method. This method sends the visitor directly to the file URL. Anyone who obtains that URL may be able to access the file without being logged in. It can also make link sharing easier, which is an important consideration for paid digital products.

Approved directory rules check whether a saved file location is allowed. They do not, by themselves, provide complete access control for every request that reaches that location. Exposure can also depend on delivery behavior and server configuration, so enabling a rule should not be presented as an automatic security solution.

The two risks to check first

  • Identify whether the file was selected from the public WordPress media library.
  • Check whether Redirect only (insecure) is the selected download method.
  • Review the file URL separately from the directory rule that covers it.
  • For paid files, add them through the WooCommerce product editor rather than selecting public media-library files.

This diagnostic order separates the storage-location question from the delivery question. It also avoids weakening directory controls merely because a public URL happens to work.

Choosing a Download Delivery Method

WooCommerce documents more controlled alternatives to Redirect only. Force downloads and X-Accel-Redirect/X-Sendfile can provide more controlled delivery, but their operation depends on server capability and configuration. They should not be described as guaranteed to secure files in every hosting environment.

Server configuration can affect whether a chosen method works as intended. In some environments, explicit server rules, including relevant NGINX configuration where applicable, may be needed. The appropriate choice therefore depends on the actual hosting setup and the location of the file.

Match the method to the storage location

Local and remote files may behave differently with the selected delivery method. For remote files, redirects can lead to destinations outside the approved URL that WooCommerce originally checked. The directory rule may therefore confirm the saved URL without validating every final destination reached by the browser.

Test the complete customer flow with the actual file location and selected method. A successful administrator-side configuration does not by itself confirm that a customer receives the file through the intended access path.

Using Cloud-Hosted Files Safely

WooCommerce supports cloud-hosted files through external URLs. The URL must comply with an enabled approved-directory rule and work with the selected download method. Cloud storage should therefore be considered part of the download design, not merely a replacement location for a local file.

Some cloud services require direct-download URLs or do not support protected delivery. The available URL may open a preview page, redirect elsewhere or expose a public destination. WooCommerce’s directory check does not remove the need to examine those behaviors.

Approve only locations that the store administrator controls or providers that the store owner trusts. This is a risk-management approach, not a universal guarantee for every cloud provider. Provider-specific behavior should be tested before a cloud-hosted file is attached to a paid product.

A cloud-file validation checklist

  1. Confirm that the external URL matches an enabled approved-directory rule.
  2. Check whether the provider supplies a direct-download URL when the selected method requires one.
  3. Test the URL with the selected WooCommerce delivery method.
  4. Review where redirects ultimately send the customer.
  5. Test the complete purchase and download flow before relying on the file for customers.

Troubleshooting Disabled or Inaccessible Downloads

When a download stops working, start with the saved product URL and the rule that should cover it. A rule may have been disabled, deleted or added by synchronization in a disabled state. The product may also reference a location that does not match the approved URL because of a path or protocol difference.

Do not assume that making a rule broader or disabling enforcement is the correct fix. First determine whether the problem is the URL, the rule status, the selected delivery method or the server capability required by that method. If the file is remote, also inspect the provider’s URL and redirect behavior.

A controlled recovery process

  1. Identify the affected product and the exact file URL saved for its download.
  2. Confirm that the URL is covered by an enabled approved-directory rule.
  3. Check whether synchronization added a matching rule that is still disabled.
  4. Review whether the rule was recently disabled or removed and whether other products use it.
  5. Check the selected delivery method and its server dependencies.
  6. Test the customer download flow after correcting the configuration.

Changing a rule can affect customers who already purchased the product, so review existing products before removing or disabling a location. If the rule is enabled but the download still fails, the research does not establish a universal fix for every hosting environment. The next review should focus on the actual server configuration and the behavior of the selected delivery method.

WooCommerce approved download directories help limit which URL-based locations downloadable products may use, especially in stores with multiple product editors. They do not replace delivery protection, server configuration or testing. Review the default woocommerce_uploads location, inspect every custom or cloud URL, avoid public media-library files for paid downloads and treat Redirect only (insecure) as an exposure risk. Before changing rules, check existing products and customer access. Finally, test the complete download flow rather than relying only on an enabled directory entry. Explore our WordPress plugins, WooCommerce extensions, themes and membership plans to find the right tools for your website.

Free Worldwide shipping

You can download the products right away at wpbetterplugins.com

Immediate delivery

After the payment is credited, the product is ready for download

International Warranty

Offered in the country of usage

100% Secure Checkout

Stripe / Apple Pay / Google Pay / MasterCard / Visa

Zadzwoń