Charitable Documentation

Learn how to make the most of Charitable with clear, step-by-step instructions.

Setting Up PayPal

PayPal is available out of the box as a payment gateway option. You can enable it via your WordPress dashboard:

  1. Go to Charitable > Settings > Payment Gateways.
  2. In the PayPal box, click on Enable Gateway.

Next, you will need to configure some settings by clicking on Gateway Settings.

Settings

General Settings

Gateway Label

The label that will be displayed in the WordPress dashboard for donations made through PayPal. This label will also be shown in the donation form to donors when you have multiple payment gateways enabled.

PayPal Email Address

This is the email address of the PayPal account that should receive all donations.

To avoid problems with having donations remain stuck as pending, ensure that this account is fully set up and approved by PayPal, and also that it is in the same currency as you have set in your Charitable settings.

Sandbox PayPal Email Address

If you would like to test out the donation process without making real transactions, you can use PayPal’s sandbox environment. This is automatically used when you have Charitable’s Test Mode setting enabled (on the Payment Gateways settings page).

If you are not sure how to create a sandbox account, read this guide about how to set up a PayPal sandbox account.

PayPal Transaction Type

PayPal offers discounted fees to registered non-profit organisations. If you have registered as a non-profit organisation, you can select “Donations” for the transaction type; otherwise select “Standard Transaction”.

Click here for more information about registering as a non-profit with PayPal.

Disable IPN Verification

If you are having problems with donations not getting marked as Paid, disabling IPN verification can sometimes fix the issue. However, it is important to be aware that this is a less secure method for verifying donations.

Find out more about how to diagnose problems with donations not getting marked as Paid: PayPal IPN Troubleshooting.

API Settings

As of Charitable 1.6, you are able to automatically refund donations in PayPal via your Charitable donation management page. This feature requires API keys.

If you use our Recurring Donations extension, API keys are also required for automatically cancelling subscriptions.

Live API Username, Password and Signature

You can find your live API details at https://www.paypal.com/businessprofile/mytools/apiaccess/firstparty/signature. You will need to log in to your PayPal account before being able to access this page.

For each setting, click on Show to reveal the setting value.

Sandbox API Username, Password and Signature

To find your sandbox API details, go to https://developer.paypal.com and click on Log into Dashboard. On the following screen, log in with your regular PayPal account details.

Next, click on Account under the Sandbox menu in the sidebar.

On the following page you will see your list of sandbox accounts. Find the Seller account (the one you are using for the Sandbox PayPal Address setting), click on Profile and then click on the API keys tab.

Still have questions? We’re here to help!

Last Modified:

What's New In Charitable

View The Latest Updates
🔔 Subscribe to get our latest updates
📧 Subscribe to Emails

Email Subscription

Join our Newsletter

We won’t spam you. We only send an email when we think it will genuinely help you. Unsubscribe at any time!

Improvement Migrations

↔️ Importing From GiveWP, Donorbox, GiveButter… even CSV!

Whether you’re migrating from another platform or consolidating your records, moving your data to Charitable is now faster and more flexible than ever. We’ve streamlined the process so you can bring over your entire fundraising history in just a few clicks.

🔄 Native GiveWP, Donorbox, & GiveButter Support: Switching from a major platform? Our dedicated migration tools handle the heavy lifting, automatically mapping your donors and donations directly into Charitable—no technical skills required.

📂 Universal CSV Import: Moving from a custom system or a specialized CRM? If you can export it to a CSV, you can import it here. Our smart mapping tool lets you align your columns to Charitable fields like names, emails, phone numbers, and addresses in seconds.

Instant Donor Profiles & Custom Tags: Automatically create rich donor profiles and bring in custom tags to keep your data organized. Segment and engage your supporters from day one with a clean, professional database structure.


Ready to make the switch?

Check out our GiveWP Migration Guide

Learn more about our Import Tools

Improvement Payments

💳 New Braintree Features For Your European Donors

With the release of Braintree addon version 1.3.0, you can now empower your European donors with the payment methods they trust and prefer, making giving seamless for international supporters.

🌍 Six New European Payment Methods: Support popular local options like iDEAL (Netherlands), Bancontact (Belgium), BLIK (Poland), and more to meet donors where they are.

⚡ Frictionless Donor Experience: These bank-based methods allow donors to authenticate directly with their own bank in a secure popup… no credit card numbers required.

⚙️ Automatic Currency Sync: No complex setup needed. The builder automatically displays the correct payment buttons based on your site’s currency (EUR or PLN), ensuring a relevant experience for every visitor.

Campaigns New

🖼️ Campaign Featured Images: Pro-Level Visuals Made Simple

With the new Campaign Featured Image setting in our visual builder, you now have a single, dedicated place to manage how your fundraisers look across your entire site and beyond.

🖼️ One Image, Everywhere: Set a primary thumbnail that automatically syncs to campaign grids, lists, and shortcodes—no more relying on layout order.

📱 Social Sharing Optimized: Easily upload images at the perfect size to ensure your campaigns look stunning and professional when shared on social media.

🔍 SEO & Accessibility Ready: Add custom alt text directly within the builder to improve search rankings and ensure your mission is accessible to every supporter.

Improvement receipts

🗓️ Annual Receipts 2.0: Send Year-End Receipts to Every Donor in Minutes

You can now send annual receipts in minutes with a few clicks to all your donors.

📧 One-Click Bulk Send Wizard that guides you to sending to hundreds of donors simultaneously directly from your WordPress dashboard.

🔍 Smart “Dry Run” Mode: See exactly who will receive a receipt and who will be skipped (and why) before a single email leaves your server.

🛡️ SMTP-Aware & Limit Protection: Charitable now detects your email setup and automatically adjusts batch sizes and pauses for daily limits to ensure your emails land in inboxes.

✅ Complete Audit Trail: Dedicated system log and on the individual donor’s profile, giving you a clear history for every fiscal year.

Stop dreading tax season and start spending that time on your mission. Update to Annual Receipts 2.0 and automate your year-end reporting today.

Addon Donations Improvement

🎈Recurring Donations 2.0: Smarter Automation, Better Recovery, and More Control

We’ve completely rebuilt our Recurring Donations system to help you grow your reliable income stream while giving you (and your donors) more powerful tools than ever before.

What’s New:

🔒 Recurring-Only Campaigns: You can toggle “Recurring Only” mode in the campaign builder to hide the one-time option entirely, ensuring your supporters stay focused on long-term commitment.

📧 Automatic Payment Recovery: Our new Payment Failed Email fires automatically the moment a subscription fails.

🛠️ Self-Service Donor Control:The new Cancel Subscription Button appears directly in the donor dashboard, allowing supporters to pause or end their recurring gifts on their own terms—reducing your admin burden and payment disputes.

📊 Real-Time Revenue Insights: Track your growth, monitor active subscriptions, and see exactly how much predictable support is coming in each month at a glance.

Our new Recurring Donations addon gives you the professional-grade tools you need to grow your mission.