Updated for Charitable Pro 1.8.20

Describe the fundraiser. Charitable builds it.

  • Connect the ChatGPT or Claude you already use, with the free WPVibe plugin
  • Ask for a campaign, a receipt for a check that came in the mail, or a report on your biggest supporters
  • It runs on your own site, against your own donor records
  • Nothing changes until you turn write access on, and anything you cannot undo previews first
  • No add-on to buy, and free AI plans work
  • WordPress 6.9+ and Charitable Pro 1.8.18+

New To AI? Start Here.

If you have used ChatGPT, you already know most of this. Here is what is new, and how to start.
Nothing to buy, nothing to install, and no setup inside Charitable.

No code, and nothing to set up.
You type what you want, the way you would ask a coworker to do it.

What Is An AI Assistant?

A chat window. You describe what you want in plain language and it answers. ChatGPT and Claude both work this way.

What Changed?

Before, an assistant could only give advice about your site. Now it does the work inside Charitable while you watch.

Why Does It Matter Here?

Small teams rarely have a developer on call. Whoever knows what the fundraiser should say can now just describe it.

Follow These Steps

Five steps, about ten minutes. You only do this once.

Step 1

Check Your Versions

WordPress 6.9 or later, Charitable Pro 1.8.18 or later. On WordPress 6.8 nothing registers and nothing about your site changes. The donor and donation work marked 1.8.20 below needs that release.

Step 2

Add A Connector

Your assistant reaches your site through a small bridge. WPVibe is a free one that works with Charitable out of the box.

Step 3

Create An Application Password

In WordPress go to Users > Profile and scroll to Application Passwords. Name it after your assistant and copy it straight away, because WordPress shows it once. This section only appears on sites served over HTTPS.

Step 4

Connect Your Site

Give your assistant your site address, your username and that password. If your connector offers a one-click approval link instead, take it, and you never type the password at all.

Step 5

Turn Write Access On

Go to Charitable > Tools > AI MCP and turn on Enable AI write access. Leave it off and you still get a genuinely useful read-only assistant for reporting.

And then you just ask

“Set up a fundraiser for the animal shelter, $5,000 goal.”

That is the whole job. There is no form to fill in, and you never name an operation.

Prefer to Watch?
The Complete Charitable AI Walkthrough
The whole setup in one video, from connecting your assistant to building a campaign by asking, in about six minutes.
Watch on YouTube →

Prompts To Try

Copy any of these and change the details to match your own fundraising. Ask in your own words if you prefer, because you never need to name an operation or fill in a form.

Build a campaign

Needs write access

Set up a fundraiser for the animal shelter, $5,000 goal, ending at the end of next month

You get a real campaign in the Campaign Builder, from a template the assistant picks from your words, with suggested amounts scaled to your goal. It arrives as a draft.

Needs write access

Create a campaign for our winter coat drive with a $2,500 goal

Needs write accessNew in version 1.8.20

Copy last year’s gala campaign and call it Gala 2027

The copy keeps the story, goal, dates, design and form settings, arrives as a draft, and starts at nothing raised. Donations are never copied.

Needs write accessNew in version 1.8.20

Use this photo on the winter coat drive and file it under Appeals

New in this release: the image is fetched into your Media Library, and categories and tags you already use are matched by name.

Works read only

What campaign templates can I choose from?

Needs write access

The winter coat drive looks right, publish it

Nothing goes live by accident: a campaign an assistant makes is a draft until you ask for it to be published.

Customize the donation form

Needs write access

Add a question asking how they heard about us

Needs write access

Make that a dropdown instead: Facebook, a friend, or our newsletter. Default it to our newsletter.

Choice fields can carry their own options and a pre-selected default, in one request.

Needs write access

Make that campaign’s donate button green

Only the button changes. Nothing else moves.

Needs write access

Move the phone number field above the payment section

Needs write access

Make the suggested amounts 25, 50 and 100, and still let people type their own

Works read only

What can you actually change on this campaign’s form?

It reads back the field types, colours, type sizes and animations this site accepts, so it is working from your vocabulary rather than guessing.

Record a gift that came in offline

Needs write access

Someone posted a check for $250 from Jane Smith, record it

It will ask for the donor's email address, and it should, because donors are matched on email and inventing one would split or merge real records.

Needs write access

Record a $1,000 cash donation to the winter coat drive

Needs write access

Log a $500 bank transfer from our board chair against the capital appeal

Put a donation right after the fact

Needs write accessNew in version 1.8.20

The bank transfer for donation 1042 has landed, mark it as paid

Moving a donation into or out of a paid status asks you to confirm, and the preview tells you to check the gateway first. Marking it paid does not collect anything.

Needs write accessNew in version 1.8.20

The check for donation 1099 bounced, set it to failed

A move between two unpaid statuses happens straight away, because nothing about it is hard to undo.

Needs write accessNew in version 1.8.20

Resend the receipt for donation 1042

Paid donations only, and once a minute at most, because it sends a real email to a real person. Ask for the donor's current address if you have just corrected it.

Needs write accessNew in version 1.8.20

Add a note to donation 1042: the donor rang to say the gift is in memory of their mother

The note joins the donation's history in your dashboard, marked as added by an assistant so you can tell it from one a colleague left. Notes cannot be edited afterwards.

Look after donor records

Needs write accessNew in version 1.8.20

Jordan wrote in with a new postal address, update their donor record

Only the fields you name change. Past donations keep the details the donor gave at the time, so old receipts still match what was sent.

Needs write accessNew in version 1.8.20

There is a typo in that donor’s email address, fix it but leave their WordPress login as it is

Changing the email of a donor who also has a WordPress account moves their login, and where password resets go, so that one asks you to confirm. You can tell it to leave the login alone.

Needs write accessNew in version 1.8.20

A donor has asked us to delete their data. Show me exactly what would be erased

The answer to a data-subject request. It always previews first: which profiles, saved details and donation fields would go, and which donations your retention setting keeps. Amounts, dates and campaign totals stay, so your reporting does not move. It refuses an administrator's account.

Works read only

What has this donor given us over the years?

A read, so it answers with write access switched off.

Ask about your fundraising

Works read only

Who are our biggest supporters?

Ranked over your whole history. Never includes an email or postal address.

Works read only

Which campaign has raised the most?

Works read only

What did we raise last month compared to the month before?

Works read only

How many donors gave more than once this year?

Works read only

Show me a day by day breakdown for the winter coat drive

Works read only

How much came from repeat donors rather than first-time donors this year?

Works read only

Export last quarter’s donations to a CSV

You get a download link rather than thirty thousand rows pasted into the chat.

Diagnose a problem

Works read only

Why aren’t my donations showing up?

It reads your gateway and test-mode status, so you get a real diagnosis instead of a guess.

Works read only

Is my site still in test mode?

Works read only

Which payment gateways are set up?

Works read only

What can my Charitable site do?

Works read only

Is AI write access switched on for this site?

Worth asking first if a request to change something was refused.

Safe By Design

Nothing is exposed to anyone who could not already do it in your dashboard. Every operation checks a Charitable capability before it runs.

An assistant signs in as a person

It connects as one of your WordPress users, with an application password that user created, and it inherits exactly that person’s permissions. There is no AI account and no separate key, so an assistant never reaches further than the person it is acting for. Every request is checked against those permissions, not just the first one.

Changes are off until you turn them on

A connected assistant reads immediately and cannot change anything until an administrator enables write access under Charitable > Tools > AI MCP. Ask it to build something with the gate off and it refuses, then tells you the exact switch to flip.

Payment credentials are never readable

Your Stripe, PayPal and Square keys are not in anything an assistant can see, whoever is asking.

Donor contact details need a second permission

Seeing that a gift arrived, for how much and to which campaign, is one level of access. A donor’s email or postal address is a separate and higher one: a list never carries it, and an address comes back only one donation at a time. From Charitable Pro 1.8.20 you also tick which roles may let an assistant read donor data at all, and that list can only narrow access, never widen it.

There is no permanent delete for a campaign

An assistant can move one to the trash, which is reversible, and nothing more. It also refuses to trash a campaign that already has donations unless you confirm.

New campaigns are drafts

Unless you ask for otherwise, so nothing goes live by accident.

The changes you cannot undo ask first

Erasing a donor’s personal data, marking a donation paid, and changing the email of a donor who has a WordPress account each run in two steps. The first one changes nothing: it returns a preview of exactly what would happen, which your assistant reads back to you. Nothing moves until you say yes, and the agreement expires after ten minutes.

Refunds and cancellations are not on the list

An assistant can move a donation between statuses, but refunding or cancelling one is deliberately left to your dashboard and your payment gateway. Marking a gateway donation paid does not move money either way.

Every change is logged

Charitable > Tools > Logs, filtered to Abilities, records what an assistant did. Charitable > Tools > System Info has an Abilities API section, the first place to look if a client connects but cannot see your data.

What You Can Do With AI
In Charitable Right Now

Two thirds of them read, the rest write, and every one is registered with the core WordPress Abilities API.

Charitable registers 39 operations, 24 of them read-only. Writes stay off until an administrator turns them on, and the handful that cannot be undone ask you to confirm even once they are on.

Charitable operations by group, as registered with the WordPress Abilities API.
GroupWhat it coversReadsWritesTotal
DiagnosticsPlugin and licence info, site environment, and gateway status. Never keys or secrets.303
CampaignsList, read, create, update, duplicate, status, trash and restore, plus the campaign image, categories and tags, donation form fields and Design styles.7916
DonationsList, read and summarise totals, record a gift that came in offline, change a status, resend a receipt, and add a note to the donation’s history.347
DonorsList donors and totals, read one donor in full where permitted, correct their details, and erase their personal data on request.325
ReportsOverview, day-by-day activity, top campaigns, top donors, named date ranges, and repeat donors against first-time donors.606
ExportDonations and donors to a CSV, handed back as a download link rather than pasted into the chat.202
All groupsEverything registered today.241539

Six of those arrived in Charitable Pro 1.8.20: correcting a donor’s details, erasing a donor’s personal data, changing a donation’s status, resending a receipt, adding a note to a donation, and duplicating a campaign. The same release let an assistant set a campaign’s image, categories and tags.

Each operation carries a description written for the assistant, telling it when that operation is the right choice and what its values mean. The complete list, how permissions map to roles, and what is deliberately out of reach are all in the full reference.

Watch And Learn

Short walkthroughs of Charitable and AI. Click any thumbnail to play it here.

Visit Our YouTube Channel

Frequently Asked Questions

The things people ask before connecting an assistant to a live fundraising site.

For Developers

An AI assistant is only one consumer of the Abilities API.
Everything here is reachable from your own code.

Charitable registers its operations with the WordPress Abilities API, which landed in core in WordPress 6.9. Any plugin can describe what it can do, and any connected client reads the same description.

An AI assistant is only one consumer

Every operation is equally reachable from your own PHP, from WP-CLI, or from any HTTP client. If you have been writing custom queries against Charitable’s tables to build a report, an ability is a supported alternative that fires the plugin’s own validation and capability checks.

The write gate is a filter

It defaults to the ai_mcp_write_enabled setting, which is off on a site that has never set it, and you can override it in code. This is the clean way to guarantee an assistant can never write on production while leaving it on in staging.

add_filter(
	'charitable_abilities_allow_write',
	function ( $enabled ) {
		if ( function_exists( 'wp_get_environment_type' ) && 'production' === wp_get_environment_type() ) {
			return false;
		}

		return $enabled;
	}
);

The gate keys off each operation’s own readonly annotation rather than a list of operation names, so a write operation added in a later release is covered by that filter automatically. Permission checks are separate and always run: every operation tests a Charitable capability before it does anything, so the gate sits on top of your role setup rather than replacing it.

This Is Just The Start

Charitable Pro 1.8.20 covers campaigns, donations, donors, reports and exports. Support for the add-ons is next, and this page is where each one gets documented as it lands.

Get Started With AI →

Machine-readable: this page as Markdown · site index

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.