how do i add a download button people can actually find

web · 2026-10-11 · 3 min

a download button is a link with a file behind it, dressed as a button. the mechanism is one line of html. what decides whether it works is where the file lives, how heavy it is, and whether the label tells people what they are about to get.

the link itself

point a normal link at the file and add the download attribute, which asks the browser to save it instead of opening it in a tab. name the file for the person who will find it six months later: listino-2026.pdf beats documento-finale-3.pdf. on wordpress, upload it to the media library and copy the file url; on wix and squarespace the same thing lives in the file manager. keep a copy you control, not only the one on the platform.

size and format

a pdf over a few megabytes is already a decision about how much you want that download. compress the images inside the document before exporting, and check the result on a phone on mobile data. if what people need is three numbers and a table, an html page loads faster and can be read on any screen. the pdf is for the version someone prints or forwards.

what goes wrong

three failures. the button is styled but not a link, so it does nothing on a phone. the file sits behind a form that asks for an email first, which halves the number of people who get it, and you cannot know if the trade was worth it. or the file is replaced every year while old links on other sites keep sending people to the 2023 version. decide the update rule before publishing.

faq

should i ask for an email before the download?

only if the document is worth more than the address, and if you actually send something afterwards. for a price list or a catalogue, gating costs you the readers who would have called. for a real guide a form can work, but say what arrives and how often.

which format should the file be?

pdf for anything meant to be printed or kept identical. for a one-page sheet, a well-built html page is lighter, searchable and readable on a phone without zooming. do not upload a scanned pdf of text you already have as text.

how do i know if anyone downloads it?

put the measurement on the click, not on the file. google analytics 4 and plausible both support events on file links, and the server logs show the requests. one event with the file name is enough; you do not need a dashboard.