Charitable Documentation

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

How to Build Automations Using Your AI Assistant and Charitable

Requires: Charitable Pro plugin 1.8.19.1+
Pro plan and higher
Automation Connect 2.4.0+
WordPress 6.9+

Do you want to build or change an automation by describing it, instead of putting it together card by card?

From Automation Connect 2.4.0, an AI assistant such as Claude or ChatGPT can list your automations, build new ones, edit and duplicate them, preview them, and switch them on and off. You connect the assistant with the free WPVibe plugin, then ask for what you want in plain language.

This guide covers what the assistant can do, the 3 switches that control it, how to turn it on, how to preview an automation, and how to fix the most common problems.

Your assistant can only do what a person with the right permission could already do in the dashboard. Every control is off until you turn it on, so nothing changes on your site until you decide it should.

Chat interface titled'Your AI Assistant' with a white panel, top-left logo, and a status badge 'Connected to Riverside Food Bank with WPVibe'; large empty chat area, input bar at bottom, and a green send button at the lower-right.

What’s in This Guide?

Watch AI-Built Automations in Action

When to Use AI-Built Automations

Asking your assistant is often quicker than opening the builder in these cases.

  • You want to build an automation faster by describing it than by putting it together in the builder.
  • You want a quick change to an existing automation, such as narrowing it to one campaign or reordering its actions, without opening the editor.
  • You want to duplicate an automation as a starting point for a similar one.
  • You want to check what an automation would do before you switch it on, with a preview that sends nothing.
  • You need to turn an automation off quickly, by asking rather than looking for it.

What Your AI Assistant Can Do With Automations

The assistant’s abilities fall into 3 groups. Reads work with every switch off, writes need the switches, and the preview changes nothing.

AI assistant chat interface with header'Your AI Assistant' and a status line 'Connected to WPCharitable Testing Ground with WPVibe'; large blank chat area; floating 'What' button in bottom-right corner

Reading Your Automations

  • It lists your automations, each with its trigger, whether it’s on or off, its action count, and whether its last run succeeded.
  • It opens one automation in full, with its trigger, conditions and ordered actions. Webhook secrets are never returned.
  • It shows an automation’s recent run history.
  • It describes the triggers, actions and condition fields available on your site, so a new automation only uses options that exist there.

Building and Changing Automations

These need the switches below, and they always leave the automation paused.

  • It creates a new automation from a trigger, optional conditions and one or more actions.
  • It edits an existing automation’s name, trigger, conditions or actions.
  • It duplicates an automation.
  • It sets an automation’s status to paused, disabled or active. Setting it to active needs the “Allow AI to switch automations on” switch.

Previewing an Automation

The preview shows what an automation would do against a recent real donation. No webhook is posted, no email is sent, and no donor is tagged.

The 3 AI Switches for Automations

All 3 switches are at Charitable » Tools » AI MCP, and all 3 are off by default.

The 3 AI access switches on the Charitable » Tools » AI MCP screen
SwitchWhat it allowsDefault
Enable AI write accessThis is Charitable’s master write switch. With it off, an assistant can read but change nothing anywhere in Charitable.Off
Allow AI to build and change automationsIt lets an assistant create, edit and duplicate automations. It also needs the master write switch above.Off
Allow AI to switch automations onIt lets an assistant set an automation to active. It’s separate from the build switch, because making an automation run on real donations is a bigger step.Off

The first switch is at the top of Charitable » Tools » AI MCP. The other 2 sit just below it, under the heading Additional Permissions (Addons).

Why AI-Built Automations Are Always Saved as Paused

One rule holds however the switches are set. Anything an assistant creates or edits is saved as paused.

  • An assistant can always pause or disable an automation.
  • An assistant can only set an automation to active when “Allow AI to switch automations on” is on.
  • With that switch off, the assistant can still build and refine freely, and a person switches the result on.

That’s what makes it safe to let an assistant draft. A paused automation doesn’t run on any donations.

How to Turn On AI-Built Automations

To get started, work through these steps in order.

  1. Make sure you’re on the Charitable Pro plugin 1.8.19.1 or later and Automation Connect 2.4.0, on WordPress 6.9 or later.
  2. Install and activate the free WPVibe plugin. The “Open WPVibe Setup” button on Charitable » Tools » AI MCP starts this for you.
  3. Connect your assistant through WPVibe. Claude, ChatGPT, Cursor and any other MCP client all connect the same way.
  4. On Charitable » Tools » AI MCP, turn on “Enable AI write access”.
  5. Under Additional Permissions, turn on “Allow AI to build and change automations”.
  6. Leave “Allow AI to switch automations on” off, unless you want the assistant to switch automations on itself rather than draft them for you to switch on.

How to Preview an Automation Before You Switch It On

Ask your assistant to preview an automation, or use the Preview action in the editor. You’ll see what it would do against a recent real donation, with nothing sent.

Run a preview before you switch any automation on, especially one with a webhook or an email. It shows the logic running without any live effect.

What AI-Built Automations Don’t Do

  • It doesn’t run anything it builds. New and edited automations stay paused until a person, or the assistant with “Allow AI to switch automations on” turned on, activates them.
  • It doesn’t touch automations at all unless both the master write switch and the build switch are on.
  • It doesn’t expose secrets. A read never returns webhook signing secrets, and payment gateway keys are never readable.
  • It doesn’t read donor contact details unless the user it acts for has Charitable’s sensitive-data permission.

How to See What the AI Changed

Charitable logs every AI action. Charitable » Tools » Logs records what was read and what was changed, and you can filter it to show only AI activity.

Tips Worth Keeping in Mind

A few habits make AI-built automations easier to trust.

  • Keep “Allow AI to switch automations on” off at first. Let the assistant draft, then switch automations on yourself until you’re comfortable with what it builds.
  • Preview every automation that sends an email or posts a webhook before it goes live.
  • After the assistant creates an automation, open it in the builder once so you can read the trigger, conditions and actions yourself.

Troubleshooting AI-Built Automations

The AI Controls Aren’t on the AI MCP Tab

Check these 3 things in order.

  1. You’re on the Charitable Pro plugin 1.8.19.1 or later. Earlier versions don’t have the Additional Permissions controls.
  2. Automation Connect 2.4.0 or later is active. Automation Connect adds the 2 automation switches, and without it you’ll only see the core “Enable AI write access” switch.
  3. You’re signed in as a user who can manage Charitable settings. The controls need the manage settings capability.

The Assistant Says Automations Are Turned Off

The message names the place to fix it, Charitable » Tools » AI MCP. Turn on “Allow AI to build and change automations”, and “Enable AI write access” above it.

Reading works either way, so the assistant can still list and open your automations.

The Assistant Won’t Switch an Automation On

Switching an automation on is a separate permission. Turn on “Allow AI to switch automations on”, or set the automation to active yourself from the Automations screen.

An Automation the Assistant Built Isn’t Running

It’s paused, by design. Review it, then set it to active.

The Assistant Can’t See a Donor’s Email

Donor emails need the sensitive-data permission, by design. If it’s appropriate, grant it to the acting user with the AI Access to Donor Data control on Charitable » Tools » AI MCP.

Developer Reference for AI-Built Automations

Permissions and Filters for AI Automation Writes

The abilities are registered in the charitable ability category and permissioned by manage_charitable_settings. The build switch and the switch-on switch are dedicated gates, layered on top of Charitable’s general AI write gate, so the call is refused if either one is off.

Both gates also need an active license and fail closed without one.

// Allow or refuse AI automation writes, regardless of the UI switch.
add_filter( 'charitable_abilities_allow_automation_write', '__return_false' );

// Allow or refuse AI switching automations on, separately.
add_filter( 'charitable_abilities_allow_automation_arm', '__return_false' );

Automation Abilities by Name

  • Reads. describe-automation-schema, list-automations, get-automation and get-automation-activity.
  • Writes. create-automation, update-automation, duplicate-automation and set-automation-status.
  • Preview. test-automation.

Conditions and actions an assistant submits are validated against the chosen trigger before they’re stored. That’s the same validation a manual edit goes through.

Wrapping Up

You can now connect an AI assistant, choose how much it’s allowed to do with your automations, and preview anything it builds before it goes live.

If you get stuck on any step, our support team is happy to help.

You May Also Want to Read

These guides cover the rest of Charitable’s AI tools and Automation Connect.

Helpful Links

🤝 Get help when you need it

Connect with Customer Support →

📑 Find the guide you need

Browse the Documentation Hub →

⬇️ Download proven strategies, campaign ideas, and expert tools

Get the Fundraising Kit →

🔗 Let your AI Assistant do the fundraising work for you.

Connect Charitable to your AI assistant →

💸 Get Free Fundraising Resources
Head to the Charitable Fundraising Hub →

🤔 Got questions about Charitable?
Charitable FAQs →

Need help understanding non-profit terms and jargon?
See our Non-Profit Glossary →

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 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.

Feature New

🎟️ Introducing Charitable Events: Sell Tickets Inside Your Campaigns!

Most nonprofits sell event tickets in one tool and collect donations in another, which leaves two sets of reports and a manual match at the end of the year. Charitable Events brings both together, selling tickets through the same donation forms and payment gateways you already run in Charitable. Why this is important:

  • 🎟️ Every ticket is a donation: Ticket sales run through the gateway you already use and count toward the campaign goal, with everything managed under Charitable » Events.
  • 📱 QR check-in from any phone: Each attendee gets their own QR code on the receipt, and volunteers scan at the door through a check-in link that needs no WordPress account.
  • 🧾 Receipts ready for tax time: Give each ticket type a fair market value, and Charitable puts the correct tax-deductible amount on every donor receipt.
  • 📋 Attendee details at checkout: Ask every guest for a meal choice, shirt size, or access needs, with a separate attendee record created for each ticket.
  • 🗓️ Blocks and calendars included: Three editor blocks plus Sugar Calendar and The Events Calendar support put your events where supporters already look.

Check out our announcement here.

ai New

🚀 Unleash AI Power in Charitable!

Your AI assistant can now build, edit, and manage your Charitable fundraising campaigns directly — just by asking. With Charitable Pro adding write support for the WordPress Abilities API, tools like ChatGPT, Claude, and Cursor can handle full administrative actions safely through MCP. Why this is important:

  • 🤖 Campaign creation in plain language: Prompt your assistant with a goal like “Set up a fundraiser for the shelter with a $5,000 goal”, and it builds a real draft campaign complete with suggested donation tiers.
  • 🎨 Instant donation form tweaks: Add custom fields, change button colors, or reorder elements without diving into form settings.
  • 📝 Offline gift logging: Tell your assistant about cash or check gifts, and it will match donor emails and record transactions into your history.
  • 🛡️ Safety and control by default: Write access stays strictly off until turned on in Charitable » Tools » AI MCP, keeping read-only reporting safe by default.
  • 📜 Full audit logging: Every change made by an AI assistant is tracked under Charitable » Tools » Logs, so you always know who (or what) updated your site.

Check out our announcement here.