How to Track File Downloads through my WooCommerce Site using the Enhanced eCommerce GA Tracking plugin?


Turning on File Downloads tracks clicks on file links across your site and reports them to GA4 as a file_download  event. This is a must-use option if you offer user guides, spec sheets, or other downloadable files alongside your products, so you can see whether customers actually download them.

Tracked file types: .zip , .exe , .pdf , .doc , .docx , .xls , .ppt , .csv , .xml .

Benefits

Enabling File Downloads tracking can help:

  • See which guides, manuals, or digital files customers actually download
  • Measure the impact of resources like installation guides on customer support and product satisfaction
  • Understand engagement with downloadable products, not just their page views

How It Works

When a visitor clicks any link on your site, the plugin checks its file extension. If it matches one of the tracked types (.zip , .exe , .pdf , .doc , .docx , .xls , .ppt , .csv , .xml ), it fires a file_download  event to GA4 with the file's extension, name, and URL.

A couple of things worth knowing:

  • Only links on your own domain are tracked as file downloads. A link to an external site fires a separate external-link event instead, even if it points to a file.
  • Mailto links are excluded. Clicking a mailto:  link fires an email-click event, not a file download.
  • The plugin briefly delays the page navigation for non-_blank  links so the tracking event has time to send before the browser moves to the file.

How to Enable File Downloads Tracking

Step 1: Open Additional Tracking

Go to Ecommerce Tracking → Tracking Configuration and open the Additional Tracking section under Tracking Configuration.

Step 2: Turn on File Downloads

Turn on File Downloads.

Step 3: Save your settings

Save your changes. From this point on, clicks on qualifying file links are tracked automatically, no extra tagging or code needed on your links.

Viewing This Data in GA4

Go to GA4 → Reports → Engagement → Events and look for file_download. Click into it to see individual downloads broken out by file name and URL, using the file_name  and link_url  parameters.

Example Use Cases

Measuring guide usage: If you link to an installation guide or spec sheet on a product page, enable this to see how many customers actually download it.

Supporting digital products: If you sell downloadable products directly, this shows whether customers are retrieving their files without needing a separate download-tracking setup.

Spotting popular resources: If you host multiple downloadable resources across your site, compare their file_download  counts in GA4 to see which ones customers use most.

Conclusion

File Downloads tracking gives you visibility into a part of the customer journey that page views alone don't show, whether people actually open the guides and files you provide. Turn it on once, and every qualifying file link on your site is tracked automatically.

FAQs

1. Which file types are tracked?

.zip , .exe , .pdf , .doc , .docx , .xls , .ppt , .csv , and .xml .

2. Are downloads hosted on another domain tracked as file downloads?

No. Links to a different domain are tracked as external link clicks instead, even if they point to a file.

No. Once the toggle is on, the plugin automatically detects and tracks clicks on any link matching a supported file type.

4. Where do I see this data in GA4?

Go to GA4 → Reports → Engagement → Events and open the file_download event to see individual files by name and URL.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.