Charitable Documentation

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

Customizing the Donation Receipt Page

Would you like to use your own WordPress page as the donation receipt instead of Charitable’s built-in receipt? The donation receipt page is what donors see immediately after completing a donation, and Charitable lets you swap the default receipt for any page on your site. This is useful if you want to match a specific page template, add custom branding, or include extra content alongside the receipt details.

This guide will walk you through the steps to set up a custom donation receipt page in Charitable.

Before you get started, make sure Charitable is installed and activated on your site. If you’d like a refresher on the default receipt experience, see How Charitable Detects the Receipt Page.

How the Default Receipt Page Works

Out of the box, Charitable uses an automatic receipt page. You don’t have to create or pick a page – when a donor completes a donation, Charitable generates the receipt on the fly using a built-in virtual page. This is the default behavior for every new install.

The automatic receipt works well for most sites, but there are a few reasons you might want to use your own page instead:

  • You want a specific page template – Choose a layout from your theme that matches the rest of your site.
  • You want to add extra content – Include a thank-you video, social sharing buttons, or a follow-up call to action above or below the receipt.
  • You want full control over the URL – Pick the exact slug donors land on after donating.

If you don’t need any of the above, the automatic receipt page is the recommended option and no setup is required.

Locating the Donation Receipt Page Setting

To find the Donation Receipt Page setting, head to Charitable » Settings in your WordPress admin. From there, open the General tab, then scroll to the Pages section.

Donation receipt page settings

The Donation Receipt Page dropdown has two types of options:

  • Automatic – The default. Charitable generates the receipt page on the fly. Choose this if you don’t need a custom layout or any extra content on the receipt.
  • A static page from your site – Any published WordPress page can be selected from the list. Choose this if you’ve created (or want to create) a dedicated receipt page with custom styling or content.

Note: If you choose a static page, that page must contain the [donation_receipt] shortcode for Charitable to display the donor’s receipt details. Without the shortcode, donors will see your page content but no receipt information.

Creating Your Custom Receipt Page

If you don’t already have a page you’d like to use, start by creating one. From your WordPress admin, go to Pages » Add New.

Give the page a clear title – something like Donation Receipt or Thank You for Your Donation. This title may appear in browser tabs and search results, so pick something donors will recognize.

Note: Don’t link to this page from your site’s main navigation or footer. The receipt page should only be reached after a donor completes a donation – visiting it directly without a donation in progress will show an empty or generic message.

Adding the Donation Receipt Shortcode

For your custom page to actually display the donor’s receipt – the donation amount, donor name, campaign details, and confirmation message – you need to add the [donation_receipt] shortcode to the page content.

While editing your page, add a Shortcode block (or paste it directly into a Paragraph block if you’re using the Classic Editor):

[donation_receipt]

You can place the shortcode anywhere on the page. Any content you add above or below the shortcode – a header, a thank-you message, social share buttons – will appear around the receipt details when donors view the page.

When you’re happy with the layout, click Publish (or Update if the page already exists).

Note: The [donation_receipt] shortcode has no attributes. It automatically pulls the correct donation for the donor viewing the page and displays the receipt details using Charitable’s standard template.

Selecting Your Custom Page in Charitable

Once your custom receipt page is published, return to Charitable » Settings » General and scroll to the Pages section.

From the Donation Receipt Page dropdown, select the page you just created. The list shows every published page on your site, so look for the title you used.

When you’ve selected your page, scroll to the bottom and click Save Changes.

Testing Your Custom Receipt Page

Before pointing real donors at the new receipt page, run a test donation to make sure everything displays correctly. We recommend using a test mode payment gateway (such as Stripe’s test mode) or the Offline Donations gateway so you can complete the donation without a real charge.

Complete a donation from start to finish. After the donation goes through, you should land on your custom page and see the receipt details rendered where you placed the [donation_receipt] shortcode. Check that the donor name, donation amount, campaign title, and confirmation message all appear correctly.

A Note About Stripe Checkout

If you’re using Stripe Checkout (the hosted Stripe payment page), your custom receipt page works exactly like any other gateway. Stripe redirects donors back to the page you’ve selected in Donation Receipt Page, and the [donation_receipt] shortcode renders the receipt details normally.

One thing to be aware of: Stripe Checkout confirms donations through a background webhook, not the redirect itself. In rare cases, a donor may land on the receipt page a moment before Stripe sends the confirmation webhook, so the donation status may briefly show as pending. The status updates automatically once the webhook arrives, usually within a second or two.

Note: If donations stay stuck on pending rather than briefly showing it, your Stripe webhook may not be configured correctly. See Setting Up Stripe Webhooks to confirm webhooks are reaching your site.

Troubleshooting

The custom page loads, but no receipt details appear

This almost always means the [donation_receipt] shortcode is missing from the page. Edit the page, confirm the shortcode is present, and make sure it’s not wrapped in any block that escapes shortcode output. The shortcode must appear exactly as [donation_receipt] with no extra attributes.

Donors are redirected somewhere else after donating

Charitable redirects donors to whichever page is selected in the Donation Receipt Page dropdown. If donors are landing elsewhere, double-check that your custom page is the one selected in Charitable » Settings » General » Pages and that you’ve clicked Save Changes.

If you’re using a caching or optimization plugin, clear your site cache after saving the settings change so the new redirect takes effect.

The receipt shows the wrong donation

The [donation_receipt] shortcode displays the donation tied to the current session or the donation ID passed in the URL. If a donor visits the receipt page directly (outside the donation flow), there’s no donation to display. This is expected behavior – the receipt page is only meant to be reached at the end of a donation.

That’s it! Donors who complete a donation will now land on your custom receipt page, and the [donation_receipt] shortcode will fill in the receipt details automatically. Next, see Customizing the Donation Receipt Template to learn how to change the receipt’s layout or fields, or Customizing the Donation Receipt Email if you’d like to update the email donors receive.

Frequently Asked Questions

Do I have to create a custom receipt page?

No. Charitable’s default Automatic setting generates a receipt page for you without any setup. A custom page is only needed if you want to control the layout, URL, or surrounding content.

What does the [donation_receipt] shortcode do?

It tells Charitable where on your custom page to render the donor’s receipt – the donation amount, donor name, campaign, payment status, and any other receipt fields. Without it, your custom page will load but won’t display any receipt details.

Can I add other content to my custom receipt page?

Yes. Anything you place above or below the [donation_receipt] shortcode – text, images, videos, blocks – will appear around the receipt on the page.

Why does the receipt page look empty when I visit it directly?

The receipt page is designed to be reached at the end of a donation, not visited directly. When there’s no active donation, the [donation_receipt] shortcode has nothing to display. This is expected – don’t link to the receipt page from your menus or footer.

Can I switch back to the automatic receipt page later?

Yes. Go to Charitable » Settings » General » Pages, change the Donation Receipt Page dropdown back to Automatic, and click Save Changes.

Where can I change what’s shown inside the receipt itself?

The fields and layout of the receipt are controlled by Charitable’s receipt template, not the page that contains the shortcode. See Customizing the Donation Receipt Template for the full walkthrough.

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.