The simplest way to make a link automatically download a file is to add the html download attribute to an HTML anchor tag. This attribute tells the browser to save the linked resource to disk instead of navigating to it or displaying it in the browser window.
How to use the html download attribute for automatic downloads
The direct answer for triggering a download is to add the download attribute to an <a> tag. The basic syntax is straightforward: <a href="path/to/your/file.pdf" download>Download File</a>. When a user clicks this link, the browser will download the file at the specified path rather than opening it. This attribute works for file types that browsers typically display inline, such as PDFs, images, or text files, forcing them to be saved to disk instead. If you need to troubleshoot why a file isn't downloading, see this download link troubleshooting guide, or if you are on the receiving end and just need to download a file from a link someone sent you. The attribute is only effective if the href attribute is also set on the <a> tag.
Setting a custom filename with the download attribute
You can suggest a specific filename for the downloaded file by providing a value to the download attribute. For example, <a href="path/to/your/file.pdf" download="MyDocument.pdf">Download Document</a> will prompt the browser to save the file as "MyDocument.pdf". If the download attribute's value is omitted, the browser will use the original filename from the href attribute. This is useful when you want to present a cleaner or more descriptive name to users without changing the actual file on the server, and once downloaded, you may need to trust a download on Windows if the file is blocked by security features.
Important caveats and browser support
The download attribute has a significant limitation: it only works for same-origin URLs. This means you can only use it for files stored on the same domain or subdomain as your website. For cross-origin files, the attribute will be ignored and the browser will open the file normally. Additionally, if both the download attribute and the Content-Disposition HTTP header specify a filename, the filename provided by the server's Content-Disposition header takes priority. Regarding browser support, the attribute is widely supported in modern browsers, including Chrome 14+, Edge 13+, Firefox 20+, Safari 10.1+, and Opera 15+.
Forcing a download with PHP for dynamic files
For cases where you need to serve files dynamically or from outside the web root, a server-side alternative using PHP provides full control. Use PHP's header() and readfile() functions to send the file with the correct headers. A basic implementation checks if the file exists, then sets headers like Content-Disposition: attachment; filename="filename.pdf" and Content-Type: application/octet-stream before outputting the file contents with readfile(). You can then create a link pointing to this PHP script: <a href="download.php">Download File</a>. This method is ideal for dynamic websites where files are generated on the fly or need to be protected behind authentication.
