Charitable Documentation

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

Charitable Newsletter Connect

With Charitable Newsletter Connect, your donors can opt-in to join your newsletter when they make their donation. Compatible with MailChimp, Campaign Monitor, MailerLite, Mailster and MailPoet (including MailPoet 3).

Installation

Installing Charitable Newsletter Connect is the same as installing any other Charitable extension. If you’re not sure how to do that, we recommend first reading our guide to installing Charitable extensions.

General Setup

After activating Newsletter Connect, you can click on the Settings link to set up the plugin. (Note: You can also get to the plugin settings by going to Charitable > Settings > Extensions.

plugin-setup

On the settings page you will see a list of all available providers.

If you’re using a WordPress newsletter plugin like MailPoet or Mailster, all you need to do is make sure that MailPoet/Mailster is activated. No further configuration is required.

Providers like MailChimp, MailerLite and Campaign Monitor need an API key or other settings in order to be connected.

Screenshot showing how providers are activated & configured.

Set up MailChimp

On the Extensions settings page, click the “Configure” button for MailChimp.

Screenshot of MailChimp configuration

There are two settings you can configure:

  • Your API Key: Find this in your MailChimp account by going to your account page > ExtrasAPI keys. (For more information about MailChimp API keys, read this).
  • Double Opt-in: Set this to “Yes” if you want subscribers to confirm their email address before being added to your newsletter list.

Configure Campaign Monitor

On the Extensions settings page, click the “Configure” button for Campaign Monitor.

Configure Campaign Monitor

Campaign Monitor requires an API key and a Client ID. You can find both of these by logging into your Campaign Monitor account and going to Account settings > API keys.

Set up MailerLite

On the Extensions settings page, click the “Configure” button for MailerLite.

MailerLite just needs an API key, which you can find in your MailerLite dashboard. Once you have this, copy it into the API key field in the Charitable settings.

Set default settings

After activating or configuring the newsletter providers you want to use, you should configure the default settings for your website. These will be applied to all campaigns, but you can override them on a per-campaign basis.

  • Default List: This is the list that donors will be subscribed to when they opt-in. It will show any available lists from your providers.
  • Default Opt-in Mode: There are three opt-in modes to choose from:
    1. An opt-in checkbox in the donation form which isn’t checked by default.
    2. An opt-in checkbox in the donation form which is checked by default.
    3. Automatic opt-in means that donors do not see a checkbox but are automatically subscribed when they donate.
  • Default Label: The label that will be shown alongside the opt-in checkbox in your donation form.

 

Screenshot showing the default settings for Newsletter Connect.

Sync lists from a provider

Charitable avoids checking for new lists with providers like MailChimp, MailerLite and Campaign Monitor. This improves performance, but it does mean that new lists you create in your provider’s account will not automatically appear as an option in your WordPress dashboard.

To fetch all your lists from a provider, you can use the Sync Lists button.

Screenshot showing how lists can be fetched from a provider like MailChimp or Campaign Monitor in WordPress with Charitable Newsletter Connect.

Setting up per-campaign configurations

You can also configure newsletter signup options on a per-campaign basis. When you edit a campaign, open the Newsletter tab.

Screenshot showing campaign newsletter settings for MailChimp, Campaign Monitor and MailPoet in WordPress.

There are three settings to configure:

  • Disable newsletter signup: Tick this to remove the opt-in for this campaign.
  • Mode: Choose how donors will opt in to your newsletter.
  • Label: Change this to a label you’d prefer instead of the default label you provided.
  • List(s): Select all the lists that you would like your donors to be subscribed to if they opt-in.

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 improved

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.

New Payments

⚡ Unlock India-Based Donations: Meet Charitable’s Native Razorpay Integration

Trying to collect donations in India? Charitable’s native Razorpay integration features:

⚡ Instant UPI Integration: Accept fast, local donations directly inside your form via apps like PhonePe, Google Pay, Paytm, and BHIM without sending donors away from your site.

📲 Auto-Generated Campaign QRs: Instantly render scannable QR codes encoding a UPI deep link directly on your public campaign pages and sidebars for an effortless “scan-to-give” experience.

💰 Dual Local & Global Reach: Headline your campaigns in INR while seamlessly accepting major international currencies like USD, EUR, GBP, and CAD to maximize global support.

🔁 Seamless Recurring Giving: Fully integrates with the Charitable Recurring addon to manage automatic monthly subscriptions directly through Razorpay without extra code.

↩️ Automatic Two-Way Sync: Keep your books perfectly clean with two-way refund syncing—issue a refund inside WordPress or your Razorpay dashboard and both sides update automatically.

🔒 Webhook-Verified Security: Automatically protect your donation records using HMAC-signed webhook verification to ensure every status update represents real money cleared on the rails.

Visit this page to learn more.

Integration New

🎉 New Built-in PushEngage Integration

Struggling with falling email open rates and rising ad costs just to keep your supporters engaged? Charitable’s built-in PushEngage integration features:

🔔 Zero-Fee Direct Messaging: Deliver crisp, instant pop-up notifications straight to your donors’ desktops and mobile devices.

⏱️ Four Smart Automated Triggers: Automatically send updates for immediate donation thank yous, full-list campaign launches, urgent “ending soon” alerts, and goal milestone celebrations.

📈 Group Momentum Broadcasts: Turn private milestones into public wins by automatically broadcasting alerts to your entire subscriber list the moment a campaign hits 50%, 75%, or 100% of its goal.

📊 Automatic Analytics Tracking: Monitor exactly where your incoming notification traffic is coming from with built-in attribution that requires zero complex configuration.

Visit this page to learn more.

New Security

💂‍♂️ New DonationGuard 🛡️ Automatically Protects Your Donations!

Worried about card testing attacks or spam bots flooding your donation forms, but don’t want to ruin the giving experience for your real supporters? Charitable’s DonationGuard features:

🛡️ Real-Time Bot Detection: Actively monitors every donation submission for five distinct attack signals without slowing down your human donors.

📊 Smart Traffic Scoring: Instantly evaluates activity against a learned baseline of your site’s normal donation rhythms to catch sneaky, slow-drip card testing.

🚨 Severity-Tiered Alerts: Immediately opens structured “Attack Records” and notifies you via email and admin alerts the moment a campaign starts taking fire.

🎯 Single-Click Defense: Deploy instant security using the “Recommended Settings” preset to turn on Honeypot, Time Trap, and Rate Limit modules all at once.

🚫 Automated Blocklists: Permanently stop repeat offenders by automatically blocking suspicious email addresses based on your customized rules.

Visit this page to learn more.

GiveWP Migrations New

🧤 White Glove Migration Service for GiveWP

Thinking about switching your fundraising platform from GiveWP to Charitable, but don’t want to risk losing your data or handle a complex technical setup yourself? Charitable’s White Glove Migration Service features:

👥 Flawless Donor Mapping: Safely transfer your entire supporter database with zero data loss.

📊 Complete Financial History: Meticulously preserve every historical transaction for continuous, accurate reporting.

🔄 Seamless Recurring Giving: Safely transfer active sustaining subscriptions without disrupting your incoming revenue or requiring your donors to update their information.

💳 Zero Gateway Disruptions: Keep using Stripe, PayPal, or any other GiveWP-compatible processor you already love.

🚀 Expert Technical Setup: Relax while our team handles the heavy lifting to install and configure your forms—plus, qualifying users get a full year of Charitable Pro completely free.

Visit this page to learn more.