Documentation Category: For Developers

  • Creator Profiles in Ambassadors Addon

    Creator Profiles give every campaign creator and fundraiser a shareable public page at /creator/your-name/, showing their avatar, bio, organization, social links, campaigns, and headline totals. Creators manage their own profile from the My Campaigns hub, and their identity now travels with them onto every fundraiser page. Available in Charitable Ambassadors 3.3.0+ (requires Charitable Pro 1.8.16 or…

  • Charitable Ambassadors: Creator Donations View

    Requires: Charitable Pro 1.8.16+ Charitable Ambassadors 3.1.0+ The Donations tab on the My Campaigns page lets each campaign creator see every donation to their own fundraiser, filter and sort the list, export a CSV, and optionally send a personal thank-you to each donor. None of this requires WordPress admin access – the whole flow lives on the front-end ambassador dashboard.…

  • Disable the Auto-Created Single Campaign Page

    When you create a campaign in Charitable, WordPress automatically gives it its own public URL at /campaigns/[campaign-slug]/. That happens because Charitable registers campaigns as a public custom post type, which is what allows search engines and direct links to reach a campaign’s own page. That works well if you want every campaign to have its own…

  • PayPal Commerce Account Type

    Requires: The Account Type setting on the PayPal Commerce gateway tells PayPal how to classify every donation your site sends to them. The choice you make here affects four things on PayPal’s side: the transaction fee tier you receive, how donor disputes are handled, how PayPal’s fraud and risk engine evaluates your transactions, and how…

  • 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…

  • 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 This guide is a reference for using and extending Charitable’s Divi integration. The Divi integration was introduced in Charitable Pro 1.8.12 and rebuilt with native Divi 5 modules in the 1.8.16 series. Charitable…

  • 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

  • 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…

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!

New templates

🤩 New Beacon Campaign Templates w/ “Hero” Block!

With the new Beacon Campaign Templates for Charitable Pro, you can launch a stunning, full-width fundraising page that instantly captures visitor attention above the fold.

🔦 Above-the-Fold Impact: Lead with a full-width hero image, your logo, and your goal with a donation widget locked right on top of the banner so your ask and momentum register instantly without scrolling.

📐 Two Flexible Layouts: Choose between a structured two-column layout for side-by-side storytelling and supporting details, or a clean one-column view designed for uninterrupted long-form narratives.

⚡ All-in-One Hero Field: Powered by the new Campaign Hero field, bringing background media, live progress bars, custom donation amounts, and recurring giving tabs together into a single cohesive block that can be dropped into any layout.

🎨 Automatic Theme Matching: The hero banner and donation widget automatically inherit your campaign theme’s button and accent colors, ensuring your entire presentation stays beautifully on-brand without touching a line of CSS.

Learn more here.

donation form Feature New

📝 Donation Form Block: Embed a Working Donation Form Anywhere

With the new Donation Form Block for Charitable Pro, you can drop a fully working donation form directly onto any page or post in the WordPress block editor. No redirects, no page reloads, and zero friction between reading your story and making a contribution.

📝 Drop Forms Anywhere: Place a working form directly onto your homepage, inside a story-driven blog post, on a dedicated landing page, or within a campaign announcement.

🎯 Dynamic Campaign Binding: Easily choose a specific campaign from the block sidebar or set it to automatically bind to whichever campaign is currently being viewed.

📐 Full vs. Minimal Form Views: Switch between a full layout or a compact minimal view to perfectly fit sidebars, narrow columns, or wide landing pages.

🎨 Scoped No-Code Styling: Customize typography, container spacing, border radius, amount buttons, and accent colors independently for every form instance without touching a line of CSS.

Learn more here.

ambassadors New

👤 Creator Profiles: Put a Face to Every Peer-to-Peer Campaign

Ambassadors 3.3.0 now provies Creator Profiles — giving your supporters a permanent, shareable public home that turns one-time fundraisers into ongoing relationships.

👤 Public Creator Pages: Give every fundraiser an instant, clean landing page at /creator/their-name/ to showcase their custom avatar, bio, and a browsable grid of their campaigns.

📊 Proof of Impact: Boost donor trust by displaying site-wide milestones on the profile—like total funds raised and total donor counts.

💳 Interactive Hover Cards: When donors hover over a creator’s name on a campaign page, a compact card expands with their bio and social handles right at the moment of decision.

📍 Responsible Location Sharing: Allow creators to safely show local supporters where they are based using only city, state, and country details.

🛠️ Self-Serve Customization: Fundraisers can update their own profiles and link up to six social networks directly from the My Campaigns hub, saving you admin time.

Ready to empower your advocates? Update to Ambassadors 3.3.0 and turn on “Enable Public Creator Page” today!

Improvement Payments

📱 Turn Mobile Scrollers Into Donors: Meet Charitable’s Mollie Upgrade

Losing mobile supporters because they hate typing out long card numbers on their phones? Charitable’s updated Mollie integration features:

⚡ One-Tap Wallet Checkout: Enable donors to complete their gifts instantly using Apple Pay or Google Pay with a simple face scan, fingerprint, or tap.

💰 No Extra PCI Burden: Skip complex domain verification and security compliance since all wallet transactions run safely through Mollie’s hosted checkout.

🛠️ Custom Cancel Routing: Keep the experience predictable by automatically sending donors who back out to your cancellation page, or use developer filters to route them to a custom page.

Visit this page to learn more.

ambassadors improved New

Moderation and Directory Screens In Ambassadors 3.0

Ambassadors 3.0 has new features: moderation and directory screens… now easily see those who are earning donations on your peer to peer network – including campaign creators that might need to be verified – all in one place. Generate reports, email ambassadors and campaign creators directly and more.

🚀 See when campaign creators and ambassadors have updated their campaigns, what donors/donation they have brought in and more.

🎉 Manually add ambassadors and campaign creators, and approve them in one-click!

Visit this page to learn more.