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

Copyright 1999-2023 by Refsnes Data. All Rights Reserved.