The restaurant has a new menu. The clinic has a patient information sheet. The trade supplier has a price list that changes every quarter. In each case there is a PDF on someone’s desktop that customers keep asking for, and it needs to be on the website, ideally somewhere they can find it, open it on a phone and download it.
To add a PDF to WordPress you need nothing beyond what is already installed. The decisions that matter come before and after the upload: whether visitors should see it on the page or download it, what the file is called, and what happens the next time it changes.
Before you upload
- Rename the file. The file name becomes part of its web address and is often shown in search results.
dinner-menu.pdfis better thanMenu FINAL v3 (2).pdf. Use lowercase letters and hyphens. - Check the size. A brochure exported from design software with full-resolution photos can be enormous. Most PDF tools have a “reduce file size” or “optimise for web” export. Smaller files open faster on phones.
- Check what is inside. Remove anything private: staff phone numbers, internal notes, tracked changes. Once uploaded, the file is public to anyone who has the link.
- Make it readable. A PDF of real text is searchable and works with screen readers. A scanned image of a page is neither. Export from the original document where you can.
How to add a PDF to WordPress with the File block
- Open the page in the editor and click where the PDF should go.
- Add a File block, either with the + button or by typing
/file. - Click Upload and choose the PDF, or Media Library if it is already on the site. You can also drag the PDF straight onto the page; WordPress creates a File block for it.
- The block shows the file name as a link, and a Download button. Click the file name text to rewrite it as something clearer, such as “Download our 2026 price list (PDF)” or simply “Dinner menu”.
- Look at the block settings on the right and choose the options described below.
- Save or update, then test the link on the live page, on a computer and on a phone.
If the upload is refused because of size, the limit is set by your server, not WordPress. Our post on raising the WordPress upload limit explains how.
Embed it or offer a download?
The File block can do both. In its settings you will find options along these lines:
- Show inline embed displays the PDF inside the page in a scrollable viewer, with a height you can set.
- Show download button adds or removes the button next to the link.
- Link to chooses whether the file name link opens the PDF itself or an attachment page.
- Open in new tab opens the PDF in a separate browser tab.
| Situation | Better choice |
|---|---|
| A one-page menu or flyer people glance at | Embed, plus the download button |
| A long brochure or catalogue | Link and download button, no embed |
| A form people print and fill in | Download button, clearly labelled |
| Something most visitors read on phones | Link only; consider putting the key details on the page as text |
The embed is less useful than it looks. Many phone browsers will not display an embedded PDF, so mobile visitors may only see the link anyway. And a viewer inside a page is awkward to read compared with opening the file in full.
For “Link to”, choose the media file. The attachment page is a thin page with little more than the file name on it, and many sites switch those pages off or redirect them, which your SEO plugin can usually handle.
Linking a PDF from text instead
Sometimes you want “see our returns policy” in the middle of a sentence. In recent versions, the editor’s link search also lists uploaded files, so typing the PDF’s title may be enough. If it does not turn up, or two versions with similar names do, copy the exact address instead:
- Go to Media → Library, click the PDF, and use Copy URL to clipboard in its details.
- Back in the page, select the words, press the link button (or Ctrl+K, Cmd+K on a Mac) and paste the address.
- It helps visitors to add “(PDF)” after the link text so they know a file will open.
When the PDF changes: keeping the same address
This is where most owners get caught. If you upload a new version of price-list.pdf, WordPress does not overwrite the old one. It saves the new file as price-list-1.pdf, with a new address. Every place that linked to the old address, including your own pages, emails you sent, QR codes on printed leaflets and Google’s search results, still points at the old version.
You have three options.
- Use a media replace plugin. Plugins such as Enable Media Replace let you upload a new file into the existing Library item, keeping the same file name and address. This is the cleanest route for a file that is linked from outside your site. Our guide to replacing a file while keeping its URL explains how these plugins work, and the same steps apply to PDFs.
- Upload a new file and update the links. Fine if the PDF is only linked from one or two of your own pages. Delete the old file afterwards so nobody finds an outdated version through search.
- Link to a page, not the file. For things that change often, link everything (emails, QR codes, social posts) to a normal page, such as
/price-list/, which contains the File block. When the PDF changes, you update the block on that one page and every outside link still works.
After replacing, browsers and caching plugins may keep showing the old file for a while. Clear your cache and test in a private window. A date in the PDF itself (“Prices from October”) makes it obvious which version a visitor has.
PDFs and search engines
Google can index PDFs and show them in search results, using the text inside them and the file name. That can be good, for a public brochure, or unwelcome, for an old price list or an internal form.
- Your SEO plugin’s noindex setting applies to pages and posts, not to PDF files themselves. Keeping a file out of search needs a server-level header, which is a job for your developer or host.
- Deleting a file that is already in search results makes it return a “not found” error; it then drops out over time.
- Anything in your uploads folder is reachable by anyone who has the address, even if no page links to it. For genuinely private documents, a members area or a form that emails the file is more suitable than a public upload.
When the information really matters for search, such as opening hours, prices or services, put it on the page as normal text as well. A web page is easier to read on a phone and easier for search engines to understand than a PDF.
PDFs are one of several kinds of file the Media Library holds, and our overview of images, files and media in WordPress explains how the Library treats them all. Menus, plugins, forms and users each have their own section in the WordPress guide for business owners this post belongs to.
Frequently asked questions
Can I see how many people downloaded my PDF?
WordPress does not count downloads itself. Google Analytics 4 records clicks on links to PDF files as file download events when enhanced measurement is on, which it is by default. Download manager plugins also keep their own counts. Either is enough for a small business to see whether a brochure is being used.
Can I stop people downloading a PDF that is shown on my page?
Not reliably. If a visitor can view a PDF in their browser, the file has already reached their device, and they can save it. Hiding the download button only removes the obvious route. If a document must stay private, do not upload it as a public file; share it through a login area or by email instead.
Can I upload Word or Excel files the same way?
Yes. WordPress accepts common office formats such as DOCX, XLSX and PPTX, and the File block handles them like a PDF, except that there is no inline embed. Visitors need suitable software to open them, which is why a PDF is usually kinder for anything people only need to read or print.
Why does my PDF open in the browser instead of downloading?
Most browsers open PDFs in a built-in viewer by default, and that is the browser’s choice rather than your website’s. The download button in the File block asks the browser to save the file, though a visitor’s own settings can still override it. Opening in the viewer is usually what people expect anyway.
If a PDF link on your site has stopped working, or you have a set of old documents that need tidying, renaming and redirecting without breaking anything, our WordPress support for small businesses covers that sort of careful clean-up.
Next in this series: How to Embed a YouTube Video in WordPress
