HTML download Attribute
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
download attribute will be the new 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/myw3schoolsimage.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 |