Documentation Category: For Developers

Browse Documentation Categories

  • Charitable Divi Integration

    This guide is a technical reference for developers working with Charitable’s Divi integration. Divi integration was introduced in Charitable Pro 1.8.12. Overview The Charitable Divi integration provides four custom modules for the Divi Builder. The integration uses Divi’s legacy ET_Builder_Module API for maximum compatibility with both Divi 4 and Divi 5. Architecture The integration follows…

  • Setting Up Square Webhooks

    Would you like Charitable to receive real-time updates when a payment is completed or refunded through Square? With Square webhooks enabled, your forms can stay in sync with Square so payment statuses are always up to date. This guide will show you how to easily connect Square webhooks with Charitable, ensuring your website stays in…

  • Hooks and filters in Annual Receipts

    Like all Charitable extensions, Charitable Annual Receipts is designed to be developer-friendly, with hooks and filters that will help you customize it to your needs. Filters Action

  • Hooks and filters in Automation Connect

    Like all Charitable extensions, Charitable Automation Connect is designed to be developer-friendly, with hooks and filters that will help you customize it to your needs. Filters Action

  • Hooks & Filters in Braintree

    Filters

  • Hooks and filters in Ambassadors

    Filters

  • User Roles and Permissions

    Charitable adds two new user roles. In addition, Charitable Ambassadors adds an additional user role. Roles Donor The donor role is given to users after they make a donation. Permissions: read Campaign Manager The campaign_manager role gives a user the ability view Charitable campaigns and donations in the admin, without being able to change settings.…

  • Donation Fields API

    The Donation Fields API is provides a powerful, flexible way to add, remove and edit your donation fields. What are donation fields? How do I get the value for a particular field? How do I add a new field to my donation form? How do I change an existing donation field? How do I add…

  • Charitable_Donation_Field

    The Charitable_Donation_Field class allows you to create new donation fields or edit existing ones. Table of Contents Usage Create a new donation field Get an existing donation field Properties Methods __construct set __set __get Usage Create a new donation field If you want to add a new donation field, you will first need to create…

  • Hooks and filters in Stripe

    Like all Charitable extensions, Charitable Stripe is designed to be developer-friendly and includes hooks and filters that will help you make any customizations you need. Filters Action Hooks

  • Charitable_User

    The Charitable_User class allows you to get access to information about a particular user. Charitable_User is a sub-class of WP_User. Getting an instance of Charitable_User Given a user ID, you can retrieve a Charitable_User instance in one of two ways: The advantage of using charitable_get_user is that it uses the object cache to retain the…

  • Charitable_Donor

    The Charitable_Donor class allows you to get access to information about a particular donor. Getting an instance of Charitable_Donor A Charitable_Donor instance can be retrieved in different ways depending on the context in which you need to use it. With a donor ID With a donor ID and a donation ID With a donation object…

  • Charitable_Campaign

    The Charitable_Campaign class allows you to get information about a particular campaign. Getting an instance of Charitable_Campaign There are two primary ways to get a Charitable_Campaign object: While both options work, we recommend using charitable_get_campaign for forward-compatibility (in case we add object caching for campaigns or filtering). Methods get( $meta_name, $single = true ) Get a value from the…

  • Hooks & Filters in Fee Relief

    Filters charitable_fee_relief_theme_template_path Customize the directory to use for template files in themes/child themes. Returns: String. Set to charitable/charitable-fee-relief by default. Arguments: None. Usage: add_filter( ‘charitable_fee_relief_theme_template_path’, function( $path ) { return ‘my-custom-template-path’; } ); charitable_fee_relief_languages_directory Customize the directory to use for translation files. Returns: String. Set to charitable-fee-relief/languages by default. Arguments: None. Usage: add_filter( ‘charitable_fee_relief_languages_directory’, function(…

  • Setting up a Stripe Webhook

    Note: Most of the time, you will not need to create a Stripe webhook manually, as Charitable will set one up for you automatically. However, if something goes wrong with that process, you can follow the steps below to (re)set up your webhook manually or to confirm your webhooks exist in Stripe. What is a…

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.

View All Announcements