Docs

addDownloadExtensions

Suggest Edits

The addDownloadExtensions() adds a file extension to the existing list of file extensions that should be tracked as downloads. Downloads are clicks on links to downloadable files.

Syntax

addDownloadExtensions(extensions)

addDownloadExtensions(extensions): void

addDownloadExtensions(extensions): void

addDownloadExtensions(extensions): void

addDownloadExtensions(extensions): void

addDownloadExtensions(extensions): void

addDownloadExtensions(extensions): void

Parameters

extensions (string | array , required)

The list of file extensions to be tracked as downloads. Can be written as string (Example: “zip|rar”) or an array (Example: [“zip”, “rar”]).

Examples

To add a mhj|docx extensions to the existing list of file extensions:

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

addDownloadExtensions(mhj|docx): void

addDownloadExtensions(mhj|docx): void

addDownloadExtensions(mhj|docx): void

addDownloadExtensions(mhj|docx): void

addDownloadExtensions(mhj|docx): void

addDownloadExtensions(mhj|docx): void

Notes

  • The list of file extensions is not persisted in a visitor’s browser. You need to call it on each page load.
  • 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 the extension:
    • 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