Clickport
Start free trial

File Downloads

Clickport automatically tracks when visitors click links to downloadable files. There is nothing to configure. As soon as the tracker is installed, download clicks are recorded alongside your other analytics data.

Free tracking. File download clicks do not count toward your monthly pageview limit. They are tracked at no extra cost on all plans.

Which file types are tracked?

The tracker detects clicks on links that end with any of these file extensions:

.pdf .doc .docx .xls .xlsx .csv .ppt .pptx .zip .rar .7z .gz .tar .mp3 .mp4 .mov .avi .dmg .exe

The check is case-insensitive, so .PDF and .pdf are both detected.

How detection works

When a visitor clicks any link on your site, the tracker checks whether the link's URL ends with a tracked file extension. If it does, the tracker sends a click event with the file URL and the link's visible text. The event is sent using fetch with keepalive: true, so it is delivered reliably even when the click causes a page navigation.

Detection happens on the <a> element, so it works for standard HTML links, links inside buttons, and links wrapped in other elements. If a visitor right-clicks and selects "Save As" without a normal click event firing, the download is not tracked.

What data is captured

Each download click records:

Only clicks on your pages are tracked. If you share a direct link to a file in an email or social media post, and someone opens it without visiting your site first, that download is not counted. The tracker only runs on pages where the Clickport snippet is installed.

Where downloads appear in the dashboard

Session timeline

When you expand a session in the Sessions panel, download clicks appear inline in the page timeline with a C badge (click event). The file URL and link text are shown so you can see exactly what was downloaded.

Session timeline with file download
09:14
/resources
Scroll 82% · 1:05
C Download Annual Report · /files/annual-report-2025.pdf
09:16
/pricing
Scroll 91% · 0:48

Goals panel

You can create a goal that tracks specific file downloads as conversions. Use the Click goal type with a condition matching the file URL. For example, to track PDF downloads:

This lets you see download conversion rates, track which traffic sources drive the most downloads, and monitor download trends over time in the Goals panel.

Outbound links panel

If the download link points to an external domain, the click also appears in the Outbound Links panel alongside other external link clicks.

Tips

Other automatic tracking

File downloads are one of several things Clickport tracks automatically. You might also be interested in: