A download link tells the browser that the linked resource is meant to be saved. The optional download value can suggest a filename. The important question is always where the link leads and whether the person reading the page can predict it.
What You Need to Know
Download treatment is most reliable for same-origin resources. Browsers and server response headers may override what happens with other origins.
Links are the pathways through a website. The words on a link should help someone choose where to go before clicking it.
Example: See It in Action
This example keeps the idea small. Copy it carefully, then follow the explanation instead of guessing what the browser will do.
This is a short HTML fragment. To try it as a webpage, put it inside the body element of a complete HTML document.
<a href="files/study-guide.pdf" download>
Download the study guide (PDF)
</a>
<p>The browser may choose how to handle cross-origin files.</p>Let’s Understand the Example
- An a element becomes a working link when it has an href. Its visible text should tell readers where they will go.
- A p groups a paragraph of related text. Start another paragraph for a new thought.
- Download suggests saving the linked resource rather than navigating to it; browser and origin rules can affect the result.
- Href contains the destination of a link. A value starting with # points to an id on the same page.
The first example link points to files/study-guide.pdf. Check whether that destination exists relative to the document. A link changes where readers go; it does not perform an action such as saving a form.
What Should You See?
You should see a link named “Download the study guide (PDF)”. Selecting it leads to files/study-guide.pdf when that destination exists. Try it with the mouse and the keyboard.
Imagine this link is read out of context. Would its text still explain the destination? Rename unclear links before trying to make them look nicer with CSS.
Try It Yourself
- Try a local PDF and another file type, then compare browser behavior.
- Save your changes, open or refresh the page, and compare the result with the original example.
- Tell a friend what your change did. If you are not sure, undo it, refresh the page, and compare.
Common Beginner Mistakes
- Assuming download works as a security check for a file.
- Avoid dead links, empty href values and clickable-looking text without a real destination.
Key Takeaways
- A download link tells the browser that the linked resource is meant to be saved.
- An a element becomes a working link when it has an href. Its visible text should tell readers where they will go.
- Download treatment is most reliable for same-origin resources. Browsers and server response headers may override what happens with other origins.