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 .
In The Article
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-
_blanklinks 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.
3. Do I need to add any code or attributes to my links?
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.