Themewaves
How-To

How to Add a Download Button in WordPress Website

Add a working WordPress download button with the editor, a plugin, or PayPal.

How to Add a Download Button in WordPress Website

What a WordPress download button does

A download button lets visitors get a file from your WordPress site with one click. It can link to a PDF, ebook, audio file, software package, or another digital item. To add a download button in WordPress, upload the file, copy its link, then connect that link to a button or file block.

Download buttons make useful files easier to find and can support sales, email sign-ups, or free resources. A clear button also tells visitors what happens next. For example, use “Download the sample PDF” instead of a vague “Click here.”

The right setup depends on the file and your goal. A simple button works well for a free file. A shop plugin is safer for paid files, while a PayPal option can collect payment or donations.

Add a basic download button with the WordPress editor

This method uses the built-in editor and does not need a plugin. First, open the page or post where the file should appear. In the media library, upload the file, or use the File block to add it directly.

  1. Upload your file. In the editor, select the plus sign and add a File block. Choose an existing file or upload a new one.
  2. Copy the file link. Select the file in the block, then copy its URL from the block settings or media details.
  3. Add a Button block. Place it near the relevant page text, then enter an action-focused label, such as “Download the guide.”
  4. Link the button. Select the button, choose the link tool, and paste the file URL. Apply the link and save or update the page.
  5. Test the result. Open the page in a private browser window and click the button. Check that the file opens or downloads as expected.

For a direct file link, the editor may show a preview or download controls instead of a styled button. If so, add a separate Button block and link it to the same file URL. In the link settings, enable “Open in new tab” only when it helps visitors keep their place on the page.

Keep the original file name clear before uploading. A link named “guide.pdf” is easier to trust than a string of random letters. Do not use this basic method to sell private files, since a public media URL may be shared.

Red notebook beside a dark tablet on a white desk, illustrating a simple website file download
Notebook and tablet on a clean desk

Use a plugin for managed downloads

Plugins can track sales, manage file access, or add forms around a download. Easy Digital Downloads is built for selling digital products. Add a downloadable product, upload or attach its file, set a price, and publish it. The plugin can then show a purchase button and give buyers access after checkout.

Follow the plugin’s current setup steps for payment and download access. Test the full path as a buyer, including checkout, receipt, and file access. This matters because a button can look right while the purchase flow still fails.

WPForms serves a different need. It can collect details or payment through a form, then show a confirmation message with a download link. This works for a lead-magnet or gated resource. It is not a full download shop, so use a dedicated digital-download tool if you need product pages, access rules, or sales tracking.

Some plugins provide a block or shortcode. A shortcode is a small tag that displays a plugin feature inside a page. Copy the exact code from the plugin, add a Shortcode block, and preview the page before publishing.

Red storage box and black folders arranged neatly to represent managed digital downloads
Organized folders beside a red storage box

Add a PayPal button for sales or donations

To add a PayPal button to a WordPress website, choose between a hosted PayPal button and a plugin-based checkout. A hosted button suits a simple sale or donation. A shop plugin is usually a better fit when each buyer needs private access to a digital file.

For a hosted button, sign in to PayPal and create a button for a sale or donation. Set the item details, price, and currency, then copy the button code or link PayPal provides. In WordPress, add a Custom HTML block and paste the code. If PayPal gives you a link instead, connect it to a normal Button block.

Publish the page and test the button on desktop and mobile. Check that the right price and currency appear, and that the PayPal checkout opens. For a paid download, make sure the buyer receives a working file link after payment. A payment button alone does not control access to a file.

You can also use a PayPal plugin that adds a block, form, or shortcode. Set up its PayPal connection first, then add the button where the offer appears. Avoid mixing several payment plugins on one page unless you have tested their checkout flows together.

Red payment card beside a black terminal on a white counter for online checkout
Red card beside a black payment terminal

Make download buttons easy to spot and trust

Place the button beside the description of the file, not far below unrelated content. Give it a strong contrast against the page background, but keep its style consistent with the rest of your site. A useful button is easy to see without taking over the page.

Use a label that names both the action and, where useful, the file. “Download the 12-page workbook” sets a better expectation than “Get it.” State whether the file is free, paid, or delivered after an email form. Clear terms reduce confusion and support requests.

  • Show the file type and size when visitors may need them, such as “PDF, 2 MB.”
  • Check the button on a phone and make sure it is easy to tap.
  • Use descriptive link text instead of repeating “Download” for several different files.
  • Keep paid files behind a purchase flow rather than linking to a public media URL.
  • Test the link after replacing or moving a file.

These small checks improve the user experience and help visitors know what the button will do. Keep the page focused on one main action when possible. If you offer several files, group them by topic and label each one clearly.

Crimson red panel and black geometric block with clear contrast on a white surface
Crisp red and black shapes on white

Fix common download button problems

If a button does nothing, check that its link includes the full file URL and that you saved the page after editing. Open the URL in a new browser tab to see whether the file itself works. A broken file link cannot be fixed by changing the button style.

If the browser opens a PDF instead of saving it, that may be normal browser behavior. Visitors can often save the file from the PDF viewer. A plugin may offer more control over download delivery, but test its settings across common browsers.

If a PayPal button is missing, confirm that the page saved the code and that the plugin or editor allows that block. Some site security tools remove code they do not trust. Use a known plugin or PayPal-provided link rather than copying code from an unknown site.

Common mistakes include linking to the wrong file, leaving a test price in place, and using a button label that hides what visitors will receive. Test every button after edits. For paid downloads, complete a test purchase before you promote the page.

Step-by-step

  1. 01
    Upload the file

    Add a File block in the WordPress editor and upload the file, or choose one from the media library.

  2. 02
    Copy the file URL

    Select the uploaded file and copy its link from the block settings or media details.

  3. 03
    Add a Button block

    Place a Button block beside the file details. Write a label that tells visitors what they will download.

  4. 04
    Link and test the button

    Paste the file URL into the button link field and save the page. Open the page in a private browser window and test the download.

Frequently asked questions

How do I add a download button in WordPress?
Upload the file to your media library, add a Button block, and link it to the file URL. Test the button after saving the page.
Can I add a download button without a plugin?
Yes. Use a Button block and link it to a file in your media library. A plugin is useful when you need paid downloads or access controls.
How do I add a PayPal button to WordPress?
Create a sale or donation button in PayPal, then add its code with a Custom HTML block or use the link in a Button block. Test the checkout before sharing the page.
Does a PayPal button deliver a digital download?
Not by itself. Set up a shop or delivery tool to give buyers access to the file after payment.
Can WPForms create a download button?
WPForms can collect information or payment and then show a download link in a confirmation message. For product listings and protected file delivery, use a digital-download plugin.
Share XFacebookWhatsApp

Related reading

About cookies on this site

Essential cookies keep pages loading and the enquiry form working. Anything beyond that is optional and we only set it if you say yes. Details live in our Cookie Policy.