Charitable Documentation

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

How to Enable and Manage Recurring Donations

Charitable’s Recurring Donations addon lets you turn one-time supporters into long-term, sustaining donors. With this extension, you can add flexible recurring giving options to any campaign, choose between simple “make this monthly” checkboxes or fully customized recurring plans, and let donors pick the schedule that works best for them.

How to Install Recurring Donations


Installing the Charitable Recurring Donations plugin 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.

Activate Recurring Donations Inside the Campaign Builder

Go to Charitable » Campaigns in your WordPress admin. Add a new campaign or edit an existing one.

Inside the campaign builder, go to the Settings tab from the far-left menu. Here, click on the Recurring Donations tab.

Click on recurring donations in settings

A popup will appear that lets you know that the Recurring Donations addon is not installed. Click on the Install and Activate button here and Charitable will begin to automatically install the addon for you.

Install and activate the recurring donations addon

Once it has been installed and activated, you’ll see a success message. Click on the Save and Reload Campaign button to refresh the page and start using the addon.

Save and reload campaign for recurring donations

If the process is successful, move ahead and customize your recurring donation options. In case this process failed for you, there may be restrictions placed by your hosting provider. You’ll need to install the addon manually.

Install Recurring Donations Manually

First, log into your Charitable account at wpcharitable.com. Go to the Downloads tab and scroll down to the addons section.

Downloads tab in account

Here, find the Recurring Donations add-on. and download the file to your computer.

Recurring donations in downloads

In your WordPress admin, go to Plugins » Add New » Upload Plugin.

Upload new wordpress plugin

Select the Recurring Donations addon file from your computer and click the Install Now button. Once installed, click the Activate Plugin button.

Activate charitable plugin

Once done, you’ll see a success message. Now you’re ready to use recurring donations in your campaigns.

Customize Recurring Donation Options

Go to the Charitable » Campaigns page inside your WordPress admin. Edit any campaign for which you want to enable recurring donations.

Add new campaign

Inside the campaign builder, go to the Settings » Donation Options tab.

Charitable settings donation options

Scroll down and you’ll see a Recurring Donations section available now. There’s a toggle button that lets you enable recurring donation options on this campaign. Simply click on it to activate it.

Allow recurring donations in campaigns

Now new options will appear that let you configure your recurring donations.

First, you can choose between Simple and Advanced recurring donations.

Simple and advanced recurring donation options

Simple – Allow donors to make their donation recurring

If you choose the Simple option, a single check box will be added to your donation form like this:

Make it monthly simple recurring donation

Donors can check it to make their contributions every month. Charitable will handle the process for you, billing the donor every month on the set date.

Advanced – Define unique giving options for recurring donations

If you choose the Advanced option, you can fine tune the recurring donation options that appear to donors. Here’s a sample of what an advanced recurring donation form can look like:

Recurring donation in campaign form

Customize Amounts and Tabs

First, you can add suggested amounts along with descriptions for each amount.

Suggested recurring donation amounts

You can also allow the donor to choose their own amount by turning on the option to “Allow Recurring Custom Donations”

Below this, Charitable lets you choose which tab should appear by default to the donors – One-time donations or Recurring Donations.

Default tab and custom recurring donation

Choose Donation Period

Next, you can set a default recurring donation period or give your donors choices.

Allow donors to choose donation period

Option 1: Restricted (No Donor Choice)

If you choose this option “No — Donors can make a recurring donation only with the default donation period.”, you’ll set one fixed recurring donation period that applies to all donors.

You’ll need to select how often donors will be billed from these intervals: weekly, monthly, quarterly, semiannually, or yearly. This creates a standardized donation schedule across your donor base.

How often should donors be billed

You’ll also have the ability to set whether these recurring donations should never expire or have a specific end date such as 2 months, 6 months, up to 24 months.

Recurring donations expires after

Option 2: Flexible (Yes to Donor Choice)

If you choose to give donors a choice, select “Yes – Allow donors to choose their donation period”.

This option provides more flexibility by allowing donors to choose their preferred donation schedule. Here, you’ll need to make two key decisions:

First, you’ll set a default period that appears as the pre-selected option when donors land on your donation page. You can choose from:

  • One-Time
  • Weekly
  • Monthly
  • Quarterly
  • Semiannual
  • Yearly

This default should reflect what you believe most donors would prefer or what works best for your organization.

Recurring donation default period

Second, you’ll select which donation periods to make available as options to your donors. You can offer any combination of:

  • One-Time
  • Weekly
  • Monthly
  • Quarterly
  • Semiannual
  • Yearly

This gives donors the freedom to choose a schedule that best fits their financial planning.

Display recurring periods

Once you’ve configured your options here, make sure to save your changes using the Save button in the top-right corner of the builder.

Now, you can preview or visit your live campaign. When you click on your Donate button, the donation form will appear and you’ll see the recurring donation options that you’ve configured.

View and Manage Recurring Donations

Charitable automatically records and safely stores all your recurring donations for you. You can access this by going to the Charitable » Recurring Donations page.

Here, you’ll see a list of your recurring donors along with:

  • Amount donated
  • Campaigns
  • Date
  • Related Donations
  • Status
View and manage recurring donations

There are actions you can take on this page. First, you can view individual donor records and delete them.

Recurring donation actions filter export

From the top menu, you can also export this list to use offline or with other tools. You can also use the search bar to quickly find the donor record you’re looking for.

Viewing Your Recurring Donations Report

Charitable comes with built-in reports and metrics to give you valuable insights into your donations.

Go to Charitable » Reports in your WordPress admin. Under the Donors tab, there is a dropdown menu to select your report. Choose the Recurring Donors option and click on the Filter button on the right.

Recurring donations report

Now you can view a list of your donors along with:

  • Total donations
  • Number of donations
  • Average
  • Number of campaigns
  • Last donation.

There are Action icons available on the far-right column. You can use this to view the campaign of this donation record. Charitable also gives you the option to download a CSV file of this report.

Custom Emails For Recurring Donations

Recurring Donations adds new emails, which can be enabled and configured in the Charitable Settings.

Here are the emails you can enable and customize:

  • Admin notification of new recurring donation
  • Admin notification when a recurring donation is renewed
  • Donor notification of new and renewal donations
  • Donor recurring donation receipt
  • Donor confirmation of cancelled recurring donation
Recurring donation emails

Email Hierarchy

If you have enabled both the “Donor: Donation Receipt” and the “Donor: Recurring Donation Receipt” emails, a recurring donation will trigger the “Donor: Recurring Donation Receipt” and not both receipt emails. If only one is enabled, then a Donor will receive the enabled email as their receipt. This separation allows you to optionally fine tune the emails sent to recurring donors.

New Email Shortcodes

Recurring Donations adds a new shortcode for emails:

[charitable_email show="recurring_summary"]
Configuration of Recurring Donation Receipt email. Shows Email subject, headline, body, and available shortcode tags.
Use the charitable email show=recurring summary shortcode in your emails to donors

This shortcode adds a new table displaying the recurring donation’s amount, frequency, status, and start date.

Gateway Setup Instructions

Depending on which payment gateway you use, you may need to follow some extra steps to get Recurring Donations up and running.

Stripe

As of Charitable Stripe 1.3.0, no additional setup steps should be required for Recurring Donations to work. Charitable handles everything under the hood.

Note: If you are using a previous version of our Stripe integration, or you notice that recurring donations are not being marked as active automatically, you may need to manually set up a Stripe webhook. Find out how to set up a Stripe webhook.

Authorize.Net

As of Charitable Authorize.Net 1.2.0, no additional setup steps are required for Recurring Donations to work. Charitable handles everything under the hood.

PayFast

No additional setup steps are required.

Cancelling Donations

As of Recurring Donations version 1.1, recurring donations can be cancelled by the site owner from the admin or by the donor from the My Accounts area.

Note: Once a recurring donation is created, the automatic renewals are handled by the payment processor and will continue to be charged even if you deactivate the Recurring Donations plugin or Charitable itself.

Cancelling in the Admin

When view the details for a particular Recurring Donation, you will see Cancel in Gateway as an option in the Donations Actions meta box for recurring donations made via a gateway that supports this feature. You may need to update your gateway plugin to see this feature.

Clicking the Cancel Recurring Donation button will cancel the recurring donation with the gateway, mark the recurring donation as cancelled locally at your site, and if enabled at Charitable > Settings > Emails, send the donor an email confirming that their recurring donation has been cancelled.

Screenshot of Recurring Donation page highlighting how to cancel a subscription.

Note: If you do not see the “Cancel in Gateway” option it means that the recurring donation cannot be cancelled by Charitable. Make sure that you are using the most recent version of Charitable Recurring Donations as well as the payment gateway integration you are using.

If you are using the most recent versions of all extensions and you still do not see this option, you will need to cancel the recurring donation within the payment gateway settings.

Cancelling from the My Donations area

It’s also possible for the donor to cancel their own subscription from within their My Donations area. By default a link to a donor’s Recurring Donations will be added to the output of the [charitable_my_donations] shortcode.

Once they view their Recurring Donations, they can “View Details” of a specific recurring donation, depending on whether the gateway supports cancellation, they will see a “Cancel” button under Actions.

Screenshot of front-end Recurring Donation receipt with button to cancel.

Shortcodes

If you wish to hide the link to a donor’s Recurring Donations from their “My Accounts” area, you can modify the [charitable_my_donations] to hide shortcode by adding the hide_recurring=1 parameter (ex: [charitable_my_donations hide_recurring=1]).

Recurring donations supports its own [charitable_my_recurring_donations] shortcode if you’d prefer to list the recurring donations in an alternative location.

Incompatibility

Please note: Recurring Donations does not work with the following extensions:

  • PayUMoney
  • Easy Digital Downloads Connect

That’s it. Next, learn more about the Donor Management System and how to use it.

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!

Donations New

👥 Introducing Donor Merging: Two Records, One Supporter!

Somewhere in your donor list is a supporter who appears twice, because they gave from a work address one year and a personal one the next. Every donation is still recorded and every receipt still went out, but a loyal supporter who has given for years can look like two people who gave half as much. From the Charitable Pro plugin 1.8.19.1 you can find those records and merge them from the Donors screen. Why this is important:

  • 🔍 A Find Duplicates link where you already work: Head to Charitable » Donors and it sits next to Filter and Export, then tells you how many groups of possible duplicates it found.
  • 🧩 Grouped by name, not by email: Charitable compares the first and last name together and ignores capital letters, spacing and punctuation, which is what catches the same person under two different addresses.
  • 📊 A preview before anything changes: Each group shows every record with its email address, its donation count and its lifetime total, and the preview shows you the combined totals and the email that will be added.
  • ↩️ Every merge can be undone: Nothing is merged until you choose to merge it, and you can reverse any merge afterwards, so a wrong guess costs you nothing.
  • 📥 Built for the week after an import: Moving donors over from another plugin is where most duplicates come from, and it is also when they are hardest to spot, because every record is new to you.

Check out our announcement here.

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.