Anchor download Property

Anchor Object Reference Anchor Object


Display the value of the download attribute of a link:

var x = document.getElementById("myAnchor").download;

The result of x will be:


Try it yourself »

Definition and Usage

The download property sets or returns the value of the download attribute of a link.

The download attribute specifies that the target will be downloaded when a user clicks on the hyperlink.

Note: The download attribute is new for the <a> element in HTML5.

Browser Support

Internet Explorer Firefox Opera Google Chrome Safari

The download property is supported in Firefox, Opera and Chrome.

Note: The download property is not supported in Internet Explorer, Safari or Opera 12 and earlier versions.


Return the download property:

Set the download property:

Property Values

Value Description
filename Specifies some text to be used as the filename (no need to specify the file extension - the browser will automatically detect the correct file extension and add it to the file, e.g. .img, .pdf. .txt, .html, etc.). If omitted, the original filename is used.

Technical Details

Return Value: A String, representing the name of the downloaded file

More Examples


Change the value of the download attribute of a link:

document.getElementById("myAnchor").download = "newValue";

Try it yourself »

Related Pages

HTML reference: HTML <a> download attribute

Anchor Object Reference Anchor Object