Charitable Documentation

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

License Requirements for Ambassadors 3.0

Requires: 

  • Charitable Pro 1.8.16+
  • Charitable Ambassadors 3.0.0+

Charitable Ambassadors 3.0 needs Charitable Pro 1.8.16 or later to work. If your Pro is on an older version, you’ll see a yellow warning when an Ambassadors 3.0 update is available. Updating Charitable Pro first is all it takes to clear it.

This page covers what the warning looks like, the right order to update, and what to do if anything looks off.

The warning on your Plugins screen

When a new Ambassadors 3.0 update is offered but your Charitable Pro is older than 1.8.16, you’ll see a yellow heads-up under the Ambassadors row:

Heads up: Charitable Ambassadors 3.0 requires Charitable Pro 1.8.16 or later. Your current version: 1.8.15.3. Please update Charitable Pro first.

The exact version numbers reflect what your site has now and what Ambassadors would update to.

If you don’t see that yellow paragraph, your Pro is already on 1.8.16 or newer and you can update Ambassadors directly.

The right order: Pro first, then Ambassadors

  1. Update Charitable Pro. Find Charitable Pro on the Plugins screen and click update now. When it finishes, the row should show version 1.8.16 or higher.
  2. Update Ambassadors. The yellow warning paragraph disappears on the next page load. Click update now on the Ambassadors row and the update proceeds normally.

You can also tick both rows under Plugins > Updates and click Update Plugins to do them together. WordPress processes them in order, so Ambassadors sees the newer Pro by the time its turn comes up.

What happens if you update Ambassadors before Pro

It depends on which Ambassadors version is currently installed:

  • On Ambassadors 2.3.11 or later: the update is stopped before your existing files are replaced. WordPress shows a clear error explaining that Pro needs to update first. Your site keeps running on the version it had a moment before.
  • On Ambassadors 2.3.10 or earlier (or if you uploaded a 3.0 zip manually): the update completes, but Ambassadors lands in a paused mode. Donations to existing fundraiser pages keep coming in, but the Ambassadors admin area is locked behind a clear “update Charitable Pro” notice until you do.

Either way, your data is safe. Campaigns, donations, ambassadors, and teams are not touched.

If Ambassadors 3.0 is already installed and Pro is still older than 1.8.16

If you ended up here, your site is in the paused mode. Recovery is short:

  • Update Charitable Pro to 1.8.16 (or later). As soon as the update finishes, the Ambassadors admin unlocks on the next page load. The notice disappears and the normal tabs return. Any fundraiser submissions that arrived while admin was paused are waiting for review.

If you can’t update Pro right now:

  • Click “Deactivate Ambassadors” on the upgrade notice page. Your data is untouched. You can reactivate later once Pro is current.
  • Or roll back to a previous Ambassadors version by downloading the 2.3.x zip from your wpcharitable.com account and uploading it via Plugins > Add New > Upload Plugin. Most sites won’t need this, but the option exists.

After Ambassadors 3.0 is installed

Two things change immediately:

  • The admin menu moves Ambassadors out from under Charitable > Settings and gives it its own top-level item at Charitable > Ambassadors.
  • A welcome notice appears at the top of the new Ambassadors screen with a link to the 3.0 release notes.

Your saved settings, campaigns, fundraisers, and donations all carry forward. No data migration is needed.

Troubleshooting

No Pro update is offered

If Charitable Pro shows your current version but no “update now” link, the update list may not have refreshed yet.

  • Go to Dashboard > Updates and click Check Again.
  • Confirm your license key is active under Charitable > Settings > General > Licenses. An expired or deactivated license stops update offers from reaching your site.

If the license is current and the update still doesn’t appear, contact us from your account at wpcharitable.com.

Your license has expired

Ambassadors 3.0 is a paid upgrade. If your support and update window has lapsed, your site won’t be offered the update. You can:

  • Renew at wpcharitable.com to restore the update offer.
  • Keep running your current Ambassadors 2.x version. It keeps working.
  • If you already landed on 3.0 with an expired license, use the Deactivate Ambassadors link on the upgrade notice page to park the plugin cleanly. Your data stays in the database.

You’re running Charitable Lite, not Pro

Ambassadors 3.0 needs Charitable Pro. If your site is on Charitable Lite, you’ll see the same warning and the upgrade is blocked. To use Ambassadors 3.0, add a Charitable Pro license. Your existing Lite donations and campaigns continue working when Pro is activated alongside.

You uploaded an Ambassadors 3.0 zip manually and the install failed

If you grabbed the Ambassadors 3.0 zip from your wpcharitable.com account and tried to install it via Plugins > Add New > Upload Plugin, the safety check stops that path too. Update Charitable Pro first, then re-try the Ambassadors zip upload. Your existing install stays untouched in the meantime.

FAQ

Why Pro 1.8.16 specifically? That’s the Pro release that introduces the helpers Ambassadors 3.0 relies on. Older Pro versions don’t have them.

Will this affect my Ambassadors 2.x site if I’m not upgrading? No. The check only fires when an Ambassadors 3.0 install is being attempted. Running Ambassadors 2.x against an older Pro keeps working normally.

Can I update Ambassadors and Charitable Pro in the same batch? Yes. WordPress processes them in order, so Ambassadors sees the newer Pro by the time it’s checked.

Will my campaigns, donations, or ambassadors be lost? No. Your data carries through every path on this page: updates, lockouts, deactivation, and even rolling back to 2.x.

Does this affect multisite networks? Yes. Each subsite checks its own active Charitable version. Update Pro network-wide first, then push Ambassadors 3.0.

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!

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.

Donations Improvement

📊 Your Pro Dashboard Can Now Compare, Export, and Score!

Most fundraising dashboards only tell you how much you have raised. Charitable Pro 1.8.19 rebuilds the dashboard and the Reports Overview around the harder questions: whether anything is broken, whether this period beat the last one, and which single change would make the most difference today. Why this is important:

  • 📈 Every figure has a trend: Pick a period and the tiles and the chart move together, with each total shown against the previous period.
  • 🗓️ Charts that stay readable: Short ranges group donations day by day, while longer ranges group by week or month, so a full year reads as a curve instead of a flat line.
  • 🔀 Compare any 2 periods: Not just consecutive ones, so you can ask how this December did against last December. That matters because fundraising is seasonal.
  • 📤 Export the whole summary: Send the full overview out as CSV or PDF, ready for a board pack or a funder report.
  • 🎯 Score your setup for free: Have your fundraising setup scored, so the one change worth making next is the one you can see.

Check out our announcement here.