Docs

setDownloadExtensions

Suggest Edits

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)

setDownloadExtensions(extensions): void

setDownloadExtensions(extensions): void

setDownloadExtensions(extensions): void

setDownloadExtensions(extensions): void

setDownloadExtensions(extensions): void

setDownloadExtensions(extensions): void

Parameters

extensions (string | array, required)

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"]).

Examples

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

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

setDownloadExtensions(mhj|docx): void

setDownloadExtensions(mhj|docx): void

setDownloadExtensions(mhj|docx): void

setDownloadExtensions(mhj|docx): void

setDownloadExtensions(mhj|docx): void

setDownloadExtensions(mhj|docx): void

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

Updated 6 days ago