How to Add a PayPal Donate Button on WordPress
Learn how to add a donate button on WordPress with PayPal. Set recurring gifts, customize the form, and manage donor info.

If you want to how to add a donate button on WordPress with PayPal, the fastest path is using the WordPress Donations block. It lets you accept one-time or recurring donations, pick donation amounts, and send payments through a supported payment processor. You still control the look of the button and the form, so it matches your site.
Below, you will get a clear flow for adding the button, wiring it to PayPal, and then handling donation management so donors stay organized. You will also see the most common problems and how to fix them.
What donation buttons do (and why they matter)
Donation buttons are a simple way to collect money on your site without building a checkout page from scratch. They work for both one-time donations and recurring donations, which is key for nonprofits and community groups planning steady support.
When people click a donate button, they expect a quick, trustworthy flow. That means clear amounts, an easy choice between frequencies, and minimal steps to finish payment. A good donation button turns interest into action.
In WordPress, donation buttons can plug into the built-in Donations experience via the Donations Form block. That block is designed to work with payment processors like Stripe and PayPal, so you can focus on your giving page instead of building payment logic.
- One-time gifts: Great for campaigns, launches, and events.
- Recurring gifts: Helps you plan income and donor engagement over time.
- Donation management: Lets you track gifts and keep donor records usable.

How to add a donate button in WordPress (core steps)
To add a donate button to WordPress, start in the editor for the page where you want giving to happen. You can add it to a standalone “Donate” page, a sidebar area, or even a blog post that supports a campaign. The goal is to place the button where the visitor is already ready to help.
In the WordPress editor, insert the Donations Form block. This block is the control center for the button experience, because it defines the form your donors see and the payment flow behind the scenes.
Next, connect the payment processor, such as PayPal, if you are using that option. Once the block shows the correct processor status, save or publish the page and test the flow as a real visitor would.
- Open the page (or post) in the WordPress block editor.
- Add the Donations Form block.
- Choose your payment processor inside the block settings.
- Set donation amounts and whether donors can choose frequency.
- Customize the button style so it fits your theme.
- Publish and test the donate flow end-to-end.
If you are asking how to add donate button on wordpress for the first time, this is the essential sequence. It reduces setup mistakes because the button is configured through the form block.

Using PayPal for donations
If your goal is how to add a paypal donate button to wordpress, PayPal needs to be available in your donation block settings. WordPress donation features are tied to plan levels, so some integrations may not show up for every account type.
You must have a WordPress.com Premium, Business, or Commerce plan to access certain donation features. If you do not see PayPal options inside the block, check your plan and permissions before you assume the setup is broken.
When PayPal is available, connect your PayPal account through the donation block prompts. After that, your donors can complete payments using PayPal without leaving your site experience more than necessary.
| What you configure | Why it matters |
|---|---|
| Payment processor (PayPal) | Routes the payment through your PayPal account. |
| Donation types | Supports both one-time and recurring donations. |
| Frequency options | Lets donors choose monthly, yearly, or another setup you allow. |
One practical tip: test with a small amount first. It proves your PayPal connection works, and it confirms your button displays correctly on mobile.
Customize the donation form (amounts, frequency, and button style)
Customization options are where your donate button becomes more than a default checkout. The donation form can include fixed amounts and also allow custom amounts. That choice affects conversion, because donors often want to give quickly at a familiar level.
Set your donation amounts in the block settings. For example, you might offer $25, $50, and $100, then include an “Other” option. If you support recurring donations, enable frequency options so supporters can pick monthly or yearly giving.
To finish, match the form and button visuals to your site’s look and feel. Use the available style controls in the block so the donate call-to-action does not look out of place. Consistent styling helps donors trust the flow.
- Custom donation amounts: Let donors choose a number when predefined options do not fit.
- Frequency controls: Configure whether donors can switch between one-time and recurring.
- Button styling: Keep color and spacing aligned with your theme.
- Donation form placement: Put the form where your message and audience interest already line up.
These are the core ideas behind how to add paypal donate button to wordpress in a way that converts. You are shaping the donation experience, not just inserting a widget.
Donation management: tracking gifts and donor info
Once donations start, donation management becomes a daily task, not an afterthought. For nonprofits, tracking gifts means you can verify payments, reconcile totals, and follow up with donors. It also helps you avoid losing donor contact data when campaigns change.
Donation management should support your reporting needs and your donor engagement strategies. For example, you might want to segment recurring donors from one-time donors, or track donations by campaign period. Even simple tagging or spreadsheets can help if you start small.
Also, confirm how donor details appear after payment. Many teams use the donation records to send thank-you emails, receipts, or updates. Make sure you know what fields are captured and where you can export or review them.
| Donation management task | What to check |
|---|---|
| Payment confirmation | Verify payments show up correctly in your records. |
| Recurring donor tracking | Confirm you can tell monthly or yearly gifts apart. |
| Donor contact info | Make sure email and names are captured for follow-up. |
| Reporting readiness | Check whether you can review totals by date or campaign. |
If you use donation data for CRM or email lists, keep that sync simple at first. Start with a clear workflow, then automate once your fields are stable.
Common issues and solutions when adding PayPal donate buttons
Even with the right steps, small setup issues happen. The quickest way to diagnose problems is to confirm the block settings first, then check your account status and payment flow.
If you cannot find PayPal in the donation block, the most common cause is plan access. Remember, you generally need a WordPress.com Premium, Business, or Commerce plan to use certain donation features. Upgrading or adjusting access should restore the PayPal options.
If payments fail, test again with a small amount. Also check that the donation button is visible on mobile and that no caching or preview settings hide the form. For payment processing, confirm your PayPal connection is still active.
- Problem: PayPal option missing in the Donations Form block.
Fix: Check your WordPress.com plan and permissions. - Problem: Donors can see the button, but checkout errors.
Fix: Reconnect PayPal in the block settings and retest. - Problem: Donation amounts or frequency choices do not match your intent.
Fix: Reopen the block settings and confirm amount and recurrence options. - Problem: Donor info does not show up for follow-up.
Fix: Review what fields the donation flow captures and adjust your process.
Finally, if you are experimenting with how to add donate button to wordpress across multiple pages, keep one reference page as your “golden” setup. Copy it after you confirm everything works, so you do not re-debug each variation.
FAQ
- How do I add a donate button on WordPress with PayPal?
- Add the Donations Form block on your page, then select PayPal in the block settings. Configure amounts and, if needed, recurring options. Save, publish, and test the full payment flow.
- Why don’t I see PayPal options in the WordPress donation form block?
- You may not have access based on your WordPress.com plan. Premium, Business, or Commerce plans are needed for some donation features. Check plan status and permissions, then re-open the block settings.
- Can donors choose between one-time and recurring donations?
- Yes, if your donation form settings allow it. Set the donation type options in the block so visitors can pick frequency that matches their giving style.
- Can I set custom donation amounts with a PayPal donate button?
- You can set fixed amounts and also allow donors to enter an “other” amount. This helps conversions when people want to give a specific amount.
- How do I manage donor information after donations come in?
- Use your donation records to track payments and store donor contact details for follow-ups. Set a simple workflow for receipts, thank-you messages, and recurring donor updates.
- What should I do if PayPal checkout fails on the donate button?
- Reconnect PayPal in the donation block settings and retest with a small amount. Also confirm the donate form is published and renders correctly on mobile.


