Charitable Documentation

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

Fixed-Term Subscriptions in Recurring Donations

Fixed-term subscriptions let you set a recurring donation to stop automatically, either after a set number of payments or on a specific end date, instead of running until someone cancels it by hand. When the term is reached, Charitable completes the subscription for you, stops billing at the payment gateway, and can email the donor a confirmation.

Available in the Charitable Recurring Donations addon 2.2.0 and later.

Key Features

  • Set a recurring donation to end after a fixed number of payments.
  • Or set it to end on a specific calendar date.
  • Subscriptions complete automatically when the term is reached, with no manual cancellation.
  • The gateway subscription is cancelled at the same time, so the donor is never charged past the term.
  • The term is displayed in the admin recurring donation screen, the donor dashboard, and the donation receipt.
  • A progress indicator shows how many payments have been made toward a payment limit.
  • Works with the existing donor approval workflow, so a term change can be approved by the donor before it applies.

Why Use Fixed-Term Subscriptions?

Many campaigns ask supporters for a defined commitment, such as a 12-month pledge or a capital campaign that runs for a set period. Previously every recurring donation ran indefinitely, so staff had to remember to cancel each one manually when the commitment ended. Fixed-term subscriptions let you set the commitment once and let Charitable end it on schedule, which keeps your reporting clean and protects donors from unexpected charges.

See It In Action

Requirements

  • Charitable Recurring Donations addon 2.2.0 or later.
  • A Stripe subscription. Subscription terms are configured through the Update Subscription screen, which currently supports Stripe.
  • For end-date enforcement to the exact day, Charitable Pro 1.8.16 or later (this uses Stripe’s native cancel_at). On earlier versions a built-in backstop still completes the subscription on the first renewal after the term is reached.

How to Set a Term on a Recurring Donation

Step 1: Update Subscription

In your WordPress admin, go to Charitable » Donations and open the recurring donation you want to limit. In the right panel, open the Donation Actions dropdown.

Donation Actions panel with a cursor selecting'Update Subscription' from the action list.

From here, click on Update Subscription.

A popup will appear that lets you change the amount, billing period, subscription term, and more.

Recurring donation subscription popup

Step 2: Set a Subscription Term

You can choose one of two options for setting the term:

Stop after a Number of Payments:

Enter the total number of payments (e.g., 12). Charitable will automatically cancel the subscription once this number of charges is completed. This is ideal for pledge drives, anniversary campaigns, and installment gifts.

Stop on a Specific Date:

Select a specific calendar date (e.g., June 3, 2027). Charitable will cancel the subscription on this date. This option suits project-based campaigns with a defined end date.

Subscription terms panel showing Stop after a number of payments set to 12 and an informational note about total payments remaining.

Step 3: Save and Confirm

  • Click on Update Subscription to apply the changes.
  • Confirm any prompts that appear.
  • Charitable will communicate the new term to Stripe immediately. The donation log will update with confirmation, reflecting the new plan and term details on the subscription record.

Step 4: Optional: Request Donor Approval for Changes

If you are making changes on behalf of a donor, such as adjusting the amount or term, you can select the option to Request Donor Approval before saving.

request donor approval

This sends an email to the donor with the proposed changes. The donor can approve or decline the changes directly from the email, ensuring a clear paper trail and maintaining the donor’s control over their giving.

When You Would Use This: Fixed Term vs. Indefinite

Not every recurring giving program needs a term. Here is a quick guide to help you decide which approach fits each campaign.

ScenarioBest approachWhy
Annual pledge drive (“Give $50/month for 12 months”)Fixed term: 12 paymentsThe commitment is defined up front. Charitable ends it automatically when the pledge is fulfilled.
Capital campaign with a funding deadlineFixed term: specific end dateThe campaign closes on a known date. No donor gets charged after the campaign ends.
Matching gift window (“We’ll match every dollar for 6 months”)Fixed term: 6 paymentsThe match expires. The recurring gift should expire with it rather than continue unmatched.
Memorial or tribute fund tied to an anniversary yearFixed term: specific end dateThe campaign honors a defined period. A fixed term closes it with intention.
New donor challenge (“Make your first 3 gifts”)Fixed term: 3 paymentsLowers the barrier for first-time recurring donors by making the commitment feel manageable.
Monthly sustaining donors with no defined endIndefiniteThe donor intends ongoing support. No term needed.
Ongoing operational or program supportIndefiniteThe need does not expire. Let the relationship continue naturally.

Configuration Options

Subscription Term types

OptionWhat it doesInputNotes
Run until cancelledThe historical default. The subscription continues until it is cancelled.NoneNo end is applied.
Stop after a number of paymentsThe subscription completes once the total payment count is reached.Whole number, 1 to 1000The admin screen shows an “X of Y payments made” progress indicator.
Stop on a specific dateThe subscription completes on or after the chosen date.A future dateThe date must be in the future. A past date is rejected.

What happens when the term is reached

When the final payment is made, or the end date passes, Charitable will: 1. Mark the recurring donation as Completed. 2. Cancel the subscription at the payment gateway so no further charges occur. 3. Send the Recurring Donation Completed email, if that email is enabled in your settings.

Where the term appears

  • Admin recurring donation screen: a Term row, with a payment-progress indicator for count-based terms.
  • Donor dashboard: a short note such as “for 12 payments” or “until June 3, 2027”.
  • Donation receipt: the same term note.

Troubleshooting

The subscription did not complete on the exact end date

Exact-day cancellation relies on Stripe’s native cancel_at, which is set by Charitable Pro 1.8.16 and later. On earlier versions, the built-in backstop completes the subscription on the first renewal after the end date passes rather than on the day itself. Update Charitable Pro for to-the-day precision.

The Subscription Term options are not showing

Term controls appear in the Update Subscription screen for active Stripe subscriptions. Subscription updates are currently supported for Stripe, so the term options will not appear for other gateways.

The Recurring Donation Completed email did not send

Confirm that the Recurring Donation Completed email is enabled under Charitable email settings. The email only fires when the subscription actually completes and the email is enabled.

Developer Resources

Hooks & Filters

  • charitable_recurring_term_type — Filters the resolved term type (unlimited, count, or end_date) for a recurring donation.
  • charitable_recurring_end_date — Filters the end-date timestamp (Unix seconds, UTC) for an end-date term.
  • charitable_recurring_renewal_donation_created — Fires after a renewal donation is created. The fixed-term backstop hooks here to complete the subscription once the term is reached.
  • charitable_recurring_donation_completed — Fires when a subscription is marked completed, which the gateway uses to cancel the subscription.

Useful Functions

  • charitable_recurring_validate_term( $type, $value ) — Validates and normalizes a proposed term, returning an array or a WP_Error.
  • charitable_recurring_calculate_end_timestamp( $start_ts, $period, $interval, $count ) — Returns the UTC timestamp at which a count-based term should stop. Calendar-aware.
  • charitable_recurring_get_term_label( $donation ) — Returns a human-readable label for a donation’s term, such as “for 12 payments” or “until June 3, 2027”.

Additional Resources

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!

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.