Use the PayPal Payment Buttons block to add a PayPal payment button to any post or page. You can use it to collect payments or donations securely through your site via PayPal. This guide will show you how to add PayPal payment buttons to your site.
To use the PayPal Payment Buttons block, you will need:
- A PayPal Business account, linked to your bank account to receive payments.
- A WordPress.com website (or the Jetpack plugin installed on a self-hosted WordPress site).
You will add the PayPal Payment Buttons block to your WordPress.com site, and then configure the PayPal button details through your PayPal account.
To add a PayPal payment button to your site, take the following steps:
- Go to your site’s dashboard.
- Navigate to the page or post you want to add the button to.
- Click the + block inserter icon and search for “PayPal” to add the PayPal Payment Buttons block.


Next, you’ll create the PayPal button code that you’ll add to the PayPal Payment Buttons block. Follow these steps to create the PayPal button code:
- Click the “Sign up” or “log in” link in the PayPal Payment Buttons block to go directly to the “Build your Payment Links and Buttons” page on PayPal.
- Or, log into your PayPal account and go to Pay & Get Paid → Create Payment Links and Buttons.
- Select the Payment Buttons option.
- Fill out the button details, like product name and description, price, etc., and click the “Build it” button at the top-right of the PayPal screen to generate the button code.
- On the “Your buttons are ready” screen, choose between “Stacked Buttons“ or “Single Button” at the top of the screen and find the HTML button code on the right.
- Copy the provided button code from the PayPal site and paste the code into the PayPal Payment Buttons block.
- Stacked Buttons: You will have two sections of HTML code to copy. The first section of the code goes in the first field of the block, and the second goes into the second available field.
- Single Button: You will only see one section of HTML code to copy. In the block, switch to the “Single Button” option and paste the HTML code.

When a visitor clicks a PayPal payment button, a new window will open to guide them through the PayPal checkout process.
Your visitor can pay using one of these three options:
- From their PayPal account using PayPal funds or a credit card.
- If they have PayPal Credit as a payment method, they will have the PayPal Credit option.
- If they don’t have a PayPal account, they can use a credit or debit card to complete the purchase.
All payments are credited to the PayPal account that was used to create the payment button code.
You can perform a test payment with the PayPal Payment Buttons block if you have a PayPal Developer account. Follow these steps to complete a test payment:
- Log in to your PayPal developer account to access or create a new sandbox account.
- Make note of your sandbox business account and personal account email addresses and passwords.
- Log in to the PayPal Sandbox site with the sandbox business account.
- Create a payment button on the PayPal sandbox site. Follow the instructions to add the payment button code to your PayPal Payment Buttons block.
- Publish the post or page that contains the block.
- Use the sandbox personal account to complete the purchase. All successful test payments will show up in the business sandbox account on the PayPal Sandbox.
If you’re using the PayPal Payment Buttons block to sell physical products, consider that the button does not take into account tax or shipping costs. Therefore, you’ll want to include that in your price. The shipping address is collected through PayPal, so once you receive your payment notification from PayPal, you’ll also receive the buyer’s address to ship the product to.
For digital products, PayPal won’t deliver the file for you — you’ll need to send the download link manually after your customers make a purchase. For an automated option, consider the Payment Buttons block because you can include the link to the file in the welcome message that is automatically emailed to your customers after purchase.
PayPal buttons are a simple way to charge for products. To add full e-commerce functionality to your site, like a shopping cart, checkout, tax, shipping, and more, install the WooCommerce plugin instead.
To collect payments, your site’s privacy settings must be set to Public.
Be sure to check that PayPal supports collecting online payments in your region. Refer to the PayPal website for a list of supported countries.
All payments are issued to the PayPal account linked to the email address you used when setting up the button. For every purchase, PayPal will send a confirmation email with the purchaser’s information to your PayPal email address. The purchaser will also receive an email from PayPal as a receipt for their purchase.
If the email you provided in the block settings is not linked to an existing PayPal account, you will receive an email from PayPal with information about claiming any collected payments. This email is sent after you receive your first payment.
WordPress.com will also send an email for each purchase. This email will be sent to your WordPress.com account email address. You can also expect a monthly report for all your PayPal Payment Buttons block. This email is sent to the owner of your site’s WordPress.com plan.
PayPal will take a fee. The amount varies depending on the payment method, the country, and other factors. Information on PayPal fees.
WordPress.com does not charge any fee or take any cut of the payments.
We have replaced the legacy Pay with PayPal block with the PayPal Payment Buttons block. If you have the legacy block on your site, it will continue to work and you can continue to customize the individual block’s settings.

When you add a new block, you will only be able to add the PayPal Payment Buttons block to your site.