Definition and Usage
The download attribute specifies that the target will be downloaded when a user clicks on the hyperlink.
This attribute is only used if the href attribute is set.
The value of the attribute will be the name of the downloaded file. There are no restrictions on allowed values, and the browser will automatically detect the correct file extension and add it to the file (.img, .pdf, .txt, .html, etc.).
If the value is omitted, the original filename is used.
Applies to
The download attribute can be used on the following elements:
| Elements | Attribute |
|---|---|
| <a> | download |
| <area> | download |
Examples
Example
Download file when clicking on the link (instead of navigating to the file):
<a href="/images/myw3iiimage.jpg" download>
Try it Yourself »
Area Example
An image-map with clickable areas that will be downloaded when clicked on:
<img src="planets.gif" width="145" height="126" alt="Planets" usemap="#planetmap">
<map name="planetmap">
<area shape="rect" coords="0,0,82,126"
alt="Sun" href="info_about_the_sun.htm" download="sun">
<area
shape="circle" coords="90,58,3" alt="Mercury" href="merglobe.gif" download="mercury">
<area shape="circle" coords="124,58,8" alt="Venus" href="information_about_the_planet_venus.txt"
download="venus">
</map>
Try it Yourself »
Browser Support
The download attribute has the following browser support for each element:
| Element | |||||
|---|---|---|---|---|---|
| a | 14.0 | 13.0 | 20.0 | Not supported | 15.0 |
| area | 14.0 | Not supported | 20.0 | Not supported | 15.0 |