Charitable Documentation

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

How to Activate PayPal Commerce

PayPal Commerce is Charitable’s modern PayPal integration – a single connection that lets your donors pay with PayPal, Venmo, Pay Later, credit and debit cards, Apple Pay, and Google Pay. This page walks you through activating it on your site and what to do if it isn’t showing up in your gateway list.

PayPal Commerce replaces the older PayPal Standard, Express Checkout, and Card Processing setups with one integration that also unlocks Venmo, Pay Later, Apple Pay, and Google Pay. Donors see modern wallet buttons and a faster checkout, and you handle refunds and recurring donations directly inside WordPress without juggling multiple PayPal products or accounts. For the full background, see Introducing PayPal Commerce.

Available in Charitable Pro 1.8.15+.

Activate PayPal Commerce

  1. In your WordPress admin, go to Charitable → Settings → Payment Gateways.
  2. Find PayPal Commerce in the gateway list and click Enable.
  3. Click Settings next to PayPal Commerce, then click Connect with PayPal.
  4. PayPal opens in a new window. Sign in to your PayPal business account (or create one) and approve the connection.
  5. PayPal redirects you back to WordPress. The connection panel will show your merchant ID and the capabilities granted to your account.

That’s it – your donation forms will immediately offer PayPal Commerce as a payment option.

Test Mode – PayPal Commerce respects Charitable’s standard Test Mode toggle. Leave Test Mode on while validating the donor flow, then turn it off when you’re ready to accept live donations.

Don’t see PayPal Commerce in your gateway list?

To keep things predictable, only one PayPal integration is shown per site at a time. If your site is already set up with the existing PayPal gateway (PayPal Standard / IPN), PayPal Commerce stays hidden by default and the gateway list shows your existing PayPal configuration instead.

Charitable decides which one to show during the 1.8.15 upgrade by checking two signals:

  • Is the existing PayPal gateway currently enabled in your settings?
  • Are there any prior donations on your site that were processed through the existing PayPal gateway?

If either of those is true, your site keeps its existing PayPal configuration and PayPal Commerce is hidden.

This is the right behavior for the vast majority of sites – running both integrations side-by-side complicates donor experience and accounting. But if you’d like to switch to PayPal Commerce anyway, you can.

Switching to PayPal Commerce

Before you switch – read this

If you have active recurring donations running through the existing PayPal gateway, please read this carefully:

  • PayPal will continue billing your donors on the schedule you set up. None of your donors will be cancelled.
  • However, after switching, Charitable will no longer record those renewals in your dashboard, because the IPN handler for the existing PayPal gateway is disabled when you switch.

If reporting on those renewals matters to you, cancel the recurring donations in your PayPal dashboard before switching. Or contact our support team – we can help you migrate active donors when our migration tool ships in a future release.

If you only have one-time historical donations and no live recurring, switching has no donor-facing impact.

Three ways to switch

Pick the path that matches your access level. All three accomplish the same thing.

Path 1 – WP-CLI (recommended for developers and agencies)

If you have shell access to your server (SSH, hosting CLI, etc.), this is the cleanest path:

wp charitable paypal force-commerce-tier --confirm-recurring-impact

The --confirm-recurring-impact flag is required when you have active recurring donations on the existing PayPal gateway. The command will refuse to run otherwise, with a count of how many donations would be affected.

Preview what would happen with the --dry-run flag before committing:

wp charitable paypal force-commerce-tier --dry-run

After the switch, go to Charitable → Settings → Payment Gateways and complete the Connect with PayPal flow on the PayPal Commerce card to start accepting donations.

Path 2 – functions.php filter (for developers without shell access)

Add this snippet to your theme’s functions.php or a small custom plugin:

add_filter( 'pre_option_charitable_paypal_user_tier', function () {
    return 'commerce';
} );

The filter runs at every get_option() call, so PayPal Commerce becomes visible immediately on the next admin page load.

This is a runtime override – it doesn’t change the stored value in your database. The override stays in effect as long as the filter is in your code; remove the filter and the original visibility is restored. If you want to make the change permanent without keeping the filter, leave it in place to verify everything works, then run the WP-CLI command from Path 1.

Path 3 – SQL update (for hosting-panel / phpMyAdmin users)

If you’re comfortable with phpMyAdmin, Adminer, or your hosting panel’s database tool, run this query against your WordPress database:

UPDATE wp_options
SET option_value = 'commerce'
WHERE option_name = 'charitable_paypal_user_tier';

Replace wp_options with your actual table prefix if it isn’t the default. The change is immediate – refresh the gateway settings page and PayPal Commerce will appear.

⚠️ Reminder: if you have active recurring donations on the existing PayPal gateway, PayPal will continue billing donors but Charitable will not record those renewals. Cancel them in PayPal first, or proceed knowing the trade-off.

What happens after switching

  • The existing PayPal gateway disappears from your gateway settings list. Its saved API credentials remain in the database in case a future reverse path is added.
  • PayPal Commerce appears in the gateway list. Its Connect with PayPal button is enabled. Click it to begin onboarding with PayPal.
  • Until you complete onboarding, PayPal Commerce shows a “not connected” status and donors will not see PayPal as a payment option on the donation form.
  • Donations recorded before the switch are not affected – they keep their original gateway tag and stay visible in your reports.

How to undo a switch

There is no in-UI undo button. The switch is one-way under the current model.

If you switched by mistake or hit an unexpected issue, please contact our support team. We can help restore your previous configuration directly, and we’re tracking these requests to inform whether we should build a proper reverse path in a future release.

Need help?

If any of this is unclear, or you’d like a hand running the switch, our support team is happy to walk you through it. Open a ticket from your Charitable account and mention “PayPal Commerce activation” – we’ll handle the rest.

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!

Donations New

👥 Introducing Donor Merging: Two Records, One Supporter!

Somewhere in your donor list is a supporter who appears twice, because they gave from a work address one year and a personal one the next. Every donation is still recorded and every receipt still went out, but a loyal supporter who has given for years can look like two people who gave half as much. From the Charitable Pro plugin 1.8.19.1 you can find those records and merge them from the Donors screen. Why this is important:

  • 🔍 A Find Duplicates link where you already work: Head to Charitable » Donors and it sits next to Filter and Export, then tells you how many groups of possible duplicates it found.
  • 🧩 Grouped by name, not by email: Charitable compares the first and last name together and ignores capital letters, spacing and punctuation, which is what catches the same person under two different addresses.
  • 📊 A preview before anything changes: Each group shows every record with its email address, its donation count and its lifetime total, and the preview shows you the combined totals and the email that will be added.
  • ↩️ Every merge can be undone: Nothing is merged until you choose to merge it, and you can reverse any merge afterwards, so a wrong guess costs you nothing.
  • 📥 Built for the week after an import: Moving donors over from another plugin is where most duplicates come from, and it is also when they are hardest to spot, because every record is new to you.

Check out our announcement here.

ambassadors New

🔑 Introducing Passwordless Fundraisers: Sign Up With Just an Email!

Supporters arrive wanting to help, and then the form asks them to invent a password for a website they may only visit twice. A lot of them stop right there. Passwordless Fundraiser Accounts, new in Charitable Ambassadors 3.5.0, let a supporter start a peer to peer fundraiser with nothing but an email address. Why this is important:

  • 🔑 No password step to lose them at: Switch it on in Charitable » Ambassadors » Templates » Submit Form and the create-fundraiser form asks only for a name, an email address and a page title.
  • 👤 Still a real WordPress account: One click in one email confirms the address, signs them in and creates the account, so they can come back later to edit their story, change their photo and see who has donated.
  • 🎚️ Your call on every campaign: Each peer to peer campaign can follow the site default or override it, which matters when a campaign pays fundraisers through Stripe Connect and those people do need a password.
  • 📋 See who has not clicked yet: The Charitable » Ambassadors » Directory » Awaiting Sign-In tab lists everyone still waiting, with the campaign they joined and a Resend button, so a typo or a spam folder is something you can spot and fix.
  • 🛡️ Links a scanner cannot use up: Opening the link only shows a page, and your fundraiser is signed in when they press the button on it, so corporate email scanners never burn the link. Each one works once, expires on its own and is stored only as a hash.

Check out our announcement here.

ambassadors New

🏃 Introducing Activity: Show Progress on More Than Money!

Most peer-to-peer fundraisers are about more than the money. A read-a-thon is about minutes read, a walkathon is about miles walked, and a food drive is about meals packed. Activity for Charitable Ambassadors lets your fundraisers show that effort right beside the dollars they raise. Why this is important:

  • 🎯 Progress on what you actually count: A progress bar shows each thing you count against its own target, sitting right beside the money raised.
  • 🏅 Milestones for the yes or no things: A milestone badge marks the efforts that are simply done or not done, with no number to chase.
  • ✍️ Fundraisers log their own numbers: Your supporters enter their totals from their own pages, so the effort stops living in a spreadsheet, a comment, or nowhere at all.
  • 🤖 Some numbers count themselves: An AUTOMATIC tag appears wherever the site worked the figure out from completed donations, so you can see at a glance what nobody typed in.
  • 🧩 Set it up once, use it anywhere: You decide what gets counted one time, then choose which campaigns count it. Available now in Charitable Ambassadors 3.4.7, with no new plugin and no developer.

Check out our announcement here.

ambassadors New

🖨️ Introducing Fliers and Posters: Raise Money Away From the Screen!

A lot of peer-to-peer fundraising happens away from a screen: at the finish line of a 5K, on a school noticeboard, in an office kitchen. Charitable Ambassadors 3.4.7 adds 2 printables, a fundraiser flier carrying each fundraiser’s own story and QR code, and a recruitment poster that signs new fundraisers up. Both open as a normal web page and print straight from the browser. Why this is important:

  • 🏁 A flier for every fundraiser: Each one carries that fundraiser’s own photo, story and goal, with a QR code that opens their page rather than your main campaign.
  • 📌 A poster that recruits: It shows “Now Recruiting” above your campaign name with a large QR code that opens your sign-up form, so someone can start fundraising without waiting on a link from you.
  • 🪄 No design tool needed: Both printables render as a normal web page and print from the browser, with no PDF plugin and no designer.
  • 📄 2 flier layouts: Hand out carries the full story for giving to friends and family, and Post up carries a short hook with 5 tear-off tabs for a noticeboard.
  • 🛡️ Off until you switch it on: Fliers stay off after the update until you enable them under Charitable » Ambassadors » Other » Fliers, and only the owner or an administrator can open one.

Check out our announcement here.

Improvement Payments

💸 Introducing Tiered Rates for Fee Relief: Match the Ask to the Gift!

Fee Relief asks your donors one short question at checkout: would you like to cover the processing fee on this gift? Until now that question used a single rate for every donation on a gateway, so a $10 gift and a $500 gift were asked for the same percentage. Fee Relief 1.3.0 lets you set as many donation bands as you like, each carrying its own rate. Why this is important:

  • 🪙 Gentler on small gifts: A fixed transaction cost is a far bigger share of a $10 donation than a $500 one, so bands let you ask for less at the bottom.
  • 🎚️ As many bands as you need: Each band carries its own percentage and its own fixed amount, and the top band runs on with no upper limit.
  • 🛑 An optional ceiling: A Maximum fee field stops any donor being asked for more than a number you choose, however large the gift.
  • 🔌 Set per payment gateway: Stripe can run on four bands while Windcave and Payfast stay on a single rate, because bands belong to a gateway and not to your whole site.
  • 🛡️ Nothing changes until you say so: Your current rates stay exactly as they are until you switch Use Tiered Rates on under Charitable » Settings » Advanced » Fee Relief.

Check out our announcement here.