Charitable Documentation

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

Charitable Rewards: Donor Experience

Requires: Charitable Pro plugin 1.8.16+
Pro plan and higher

A donor who earns a reward shouldn’t have to email you to find out what they got. Rewards shows their claims everywhere a donor already looks.

This guide covers the donation receipt, the donor dashboard, the My Donations shortcode, the reward cards shortcode and the levels mini widget.

When donors can check their own rewards, you’ll answer far fewer “where is my thing” emails.

Charitable Rewards needs version 1.8.16 or higher of the Charitable Pro plugin, on the Pro plan and higher.

What’s In This Guide?

Watch the Video

If you’d rather watch than read, this short video shows what your donor sees.

On the Donation Receipt

Straight after donating, the receipt lists what the gift earned. For a reward not yet fulfilled, a short pending note sets expectations rather than leaving a bare line item.

With tax receipting turned on, the receipt also discloses the deductible portion. See Tax Receipting.

In the Donor Dashboard

If your site uses Charitable’s donor dashboard, Rewards adds 2 things to it.

The Rewards tab on the donor dashboard, listing 2 claimed rewards with their donation, campaign, status, date and delivery details
  • A rewards column on the donations table, showing a small indicator on any donation that earned something.
  • A Rewards tab, listing everything that donor has claimed with its current status.

The tab is where a donor goes to answer “has my tote bag shipped yet?” That’s the question you most want them answering for themselves.

In the My Donations Shortcode

Sites using [charitable_my_donations] rather than the full dashboard get a rewards column there too. The donation history then shows which gifts earned perks.

Both places use the same renderer, so a claim looks the same wherever a donor sees it.

The Reward Cards Shortcode

Reward cards don’t have to live on a donation form. The shortcode shows them on any page or post.

Reward cards rendered on a standalone page using the charitable_reward_cards shortcode
[charitable_reward_cards]

Here are a few places it helps.

  • A dedicated “ways to give” page that explains the tiers before anyone reaches a form
  • A campaign landing page where the cards are the pitch
  • An email-friendly page you can link supporters to

The cards are for display in this context. Donating still happens on the campaign’s own form, which the cards link to.

The Levels Mini Widget

Where levels are in use, a compact widget sums up the giving tiers for a sidebar or a narrow column, without the full card design.

What a Donor Cannot Do

Knowing these limits helps you answer donor questions with confidence.

  • Change a claim. Once a reward is earned, the donor can’t swap it for a different one. That’s a conversation with you.
  • Re-download past an expired link. Digital download links expire. Resend the delivery email rather than sending the file directly, so the download counts stay right.
  • See other donors’ claims. A donor only ever sees their own.

Tips Worth Keeping in Mind

These small steps save you a lot of donor emails.

  • If you use the donor dashboard, point donors to the Rewards tab in your confirmation email. It answers most “where is my thing” questions.
  • Put [charitable_reward_cards] on a ways-to-give page for campaigns where the perks are a big part of the pitch.
  • Fill in estimated delivery on physical rewards. The receipt and dashboard both show it, and it answers the timing question before it’s asked.

FAQs on the Donor Experience

Can a donor swap their reward for a different one?

No. Once a reward is earned, the donor can’t change it themselves, so they’ll need to contact you.

Can donors donate from the reward cards shortcode?

The cards link to the campaign’s own donation form, and the donation happens there.

Why is the Rewards tab missing from my donor dashboard?

A theme that overrides the donor dashboard templates without keeping Charitable’s hooks will lose the rewards column and tab. Check your theme’s template overrides first.

Developer Reference

Shortcode

ShortcodeRenders
[charitable_reward_cards]Reward cards for a campaign, outside the donation form

Filters

FilterPurpose
charitable_reward_cards_shortcodeFilter the shortcode output or its resolved attributes
charitable_rewards_receipt_headingHeading of the rewards block on the receipt
charitable_rewards_receipt_pending_noteThe note shown against a claim not yet fulfilled
charitable_rewards_view_modelsThe view models behind card rendering, shared by form and shortcode
charitable_rewards_form_headingHeading above the rewards block on a donation form
charitable_rewards_form_heading_no_rewardThat heading when no reward is currently in reach
charitable_rewards_summary_labelThe label used in the donation summary
charitable_rewards_change_amount_level_labelLabel on the “change your level” link in levels mode
charitable_rewards_change_amount_level_linkThe link itself

Integration Hooks Used

Rewards attaches to Charitable’s own donor-facing tables rather than replacing them.

HookAdds
charitable_my_donations_table_header_after_receiptThe rewards column header in My Donations
charitable_my_donations_table_after_receiptThe rewards cell in My Donations
charitable_donor_dashboard_donations_table_header_after_actionsThe rewards column header in the dashboard
charitable_donor_dashboard_donations_table_after_actionsThe rewards cell in the dashboard
charitable_donor_dashboard_after_campaigns_nav_tabThe Rewards nav tab
charitable_donor_dashboard_after_campaigns_tab_contentThe Rewards tab content

Because these are additive hooks, a theme that overrides the donor dashboard templates without keeping those hook calls will lose the rewards column and tab.

If a client’s dashboard is missing them, check the theme’s template overrides first.

Customization Examples

Reword the rewards heading on the donation form.

add_filter( 'charitable_rewards_form_heading', function () {
    return __( 'Pick your thank-you gift', 'your-textdomain' );
} );

Change the pending note donors see on receipts.

add_filter( 'charitable_rewards_receipt_pending_note', function () {
    return __( 'We will email you as soon as this ships.', 'your-textdomain' );
} );

Wrapping Up

You now know where donors see their rewards, how to show reward cards on any page, and what donors can and can’t change themselves.

If you get stuck on any step, our support team is happy to help.

You May Also Want to Read

These guides cover what happens behind the screens your donors see.

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.