setDownloadExtensions

The setDownloadExtensions() method overwrites the list of file extensions that should be tracked as downloads. Downloads are clicks on links to downloadable files.

Syntax

setDownloadExtensions(extensions)
Not available
Not available
Not available
Not available
Not available
Not available

Parameters

ParameterTypeDescriptionRequired
extensionsstring | array<string>The list of file extensions to be tracked as downloads. Can be written as a string (Example: "zip|rar") or an array (Example: ["zip", "rar"]).Yes

Examples

To set the list of file extensions as mhj|docx and overwrite the default one:

_paq.push(["setDownloadExtensions", "mhj|docx"]);
Not available
Not available
Not available
Not available
Not available
Not available

Notes

  • The list of file extensions is not stored in a visitor's browser. You need to call it each time a page is loaded.
  • We check for extensions at the end of the URL path and in query parameter values. Here are a few examples of how we detect extensions:
    • http://example.com/path/file.zip
    • http://example.com/path/file.zip#hello
    • http://example.com/path/file.zip?a=102
    • http://example.com/path/?a=file.zip
    • http://example.com/path/?a=file.zip&b=29
  • Here's the default list of file extensions tracked as downloads: 7z, aac, apk, arc, arj, asf, asx, avi, azw3, bin, csv, deb, dmg, doc, docx, epub, exe, flv, gif, gz, gzip, hqx, ibooks, jar, jpg, jpeg, js, mobi, mp2, mp3, mp4, mpg, mpeg, mov, movie, msi, msp, odb, odf, odg, ods, odt, ogg, ogv, pdf, phps, png, ppt, pptx, qt, qtm, ra, ram, rar, rpm, sea, sit, tar, tbz, tbz2, bz, bz2, tgz, torrent, txt, wav, wma, wmv, wpd, xls, xlsx, xml, z, zip.

Related methods