How to upload a PDF to WordPress and make it downloadable

A catalogue, programme or form can live on your website instead of being sent by email every time. Upload a PDF to WordPress through the Media Library, then insert it with the File block. This tutorial follows a generic sample catalogue from preparation to the final link check.

1. Prepare your PDF

Open the document on your computer and check its pages, links and file size. Choose a descriptive filename such as sample-catalogue.pdf instead of final-version2.pdf. Export a version suitable for the web. Whenever possible, retain selectable text, logical headings and other accessibility features rather than uploading scanned pages without a text layer.

2. Upload the document

In the dashboard, go to Media > Add Media File and choose Select Files. Select your PDF and wait for the upload to finish. The maximum file size displayed on this screen depends on the server. If your PDF is larger, optimise the document or ask your site administrator to check the upload configuration.

The upload screen and server-defined file size limit.
Figure 1. The upload screen and server-defined file size limit.

3. Add a File block

Open your post, use the + inserter and search for File. Choose Media Library for a document already uploaded, or Upload to add one now. Search for the filename, select the correct PDF and confirm. The example uses a filtered list containing only the generic catalogue, making it easier to identify the right document.

The sample PDF selected in the Media Library.
Figure 2. The sample PDF selected in the Media Library.

4. Label the link and download button

Replace the technical filename with a useful label such as Example catalogue (PDF). In the File block settings, select Media file as the link destination and enable Show download button. Give the button a clear label, such as Download catalogue. Whether the browser saves or displays the document can also depend on browser and server behaviour.

File block: label, link destination and download button.
Figure 3. File block: label, link destination and download button.

5. Decide whether to embed the PDF

Enable the inline embed if you want the document to appear inside the page. Leave it off if a simple file link is enough. Embedded previews may behave differently on phones, so keep a recognisable text link available. Mention the file format and, for a large document, its approximate size to help visitors decide whether to download.

6. Save and check the link

Save your draft or update an existing published post. Open View and inspect the preview, then test the PDF link: it should lead to the correct document without an error. Check on a phone as well. After publishing, test while logged out and reopen the downloaded file to confirm it is readable.

The preview modes available in the editor.
Figure 4. The preview modes available in the editor.

Frequently asked questions

Does a page password also protect the PDF?

Not automatically. The uploaded file can remain available through its direct URL. Confidential downloads need access controls that protect the files themselves.

How do I replace an old PDF?

Upload the new document, replace the file in the block and update the post. Check other links to the old document too; reusing a filename does not guarantee that the old URL is replaced.