Quick Tip: Using the HTML5 Download Attribute

If you have server-side access to your website there are some workarounds you can use, such as configuring the .htaccess, to download these files directly. If your site is hosted with a free service like WordPress.com, Blogspot, or perhaps Github pages which don’t allow you to do so, consider using the download attribute.

Using the HTML5 Download Attribute

The download attribute is part of the HTML5 spec and expresses a link as download link rather than a navigational link.

Syntax

1

<a href="download/acme-doc.txt" download>Download Text</a>

The download attribute allows you to optionally rename the file name upon downloading. When the file resides on the server, especially if it’s been automatically generated, this can be ideal for giving users a file with a more sensible name when downloaded, perhaps like: Acme Documentation (ver. 2.0.1).txt (not forgetting the file extension).

Here’s how that would look in practice:

1

<a href="download/acme-doc-2.0.1.txt" download="Acme Documentation (ver. 2.0.1).txt">Download Text</a>

Give it a try on the demo page, and you should find the file downloaded with the name specified in the download attribute.

A Couple of Notes:

• Firefox only allows users to download files of the same origin due to a security concern. The file must come from your own server or domain name, otherwise it will be opened in the browser. 
• While downloading cross-origin files is allowed in Chrome and the latest Opera (with Chromium/Blink), they will both ignore the attribute value. In other words, the file name will remain unchanged.

Providing Fallback for Internet Explorer

The download attribute has not been implemented in Internet Explorer, though it is supported by Edge. 

In order to make things bullet proof we can add a decent fallback, such as providing extra instructions below the download link for non-supporting browsers. To do so, we will need to download Modernizr with the download feature test included.

Then we can add the following script.

1

if ( ! Modernizr.adownload ) {

2

	var $link = $('a');

3

4

	$link.each(function() {

5

		var $download = $(this).attr('download');

6

7

		if (typeof $download !== typeof undefined && $download !== false) {

8

      var $el = $('<div>').addClass('download-instruction').text('Right-click and select "Download Linked File"');

9

      $el.insertAfter($(this));

10

		}

11

12

	});

13

}

The script will test whether the browser supports the download attribute; if not it will append a new <div> with the class for styling purposes as well as the instruction text, and insert it immediately below any link which has been furnished with the download attribute.

Conclusion

The HTML5 download attribute makes handling download links very convenient for anyone who has no access to server-side configuration.

Learn More HTML

• 

  HTML & CSS for Beginners (MEGA Free Course!)

  

  Adi Purdila

  08 Sep 2022

• 

  HTML Element: a

  

  Andy Leverenz

  16 Mar 2023