Charitable Documentation

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

Honoree Records and the CRM in Charitable Tributes

Requires: 

Charitable Pro 1.8.16+
Charitable Tributes 1.0.0+

This is the feature that sets Charitable Tributes apart from a simple tribute checkbox. When a donor honors someone, Tributes creates a lasting honoree record in your dashboard. Each honoree has running totals, the list of donors who gave in their name, the messages left for them, and the family contacts you choose to keep.

So when 10 people give in memory of the same person, you see one honoree with the full picture, not 10 disconnected donations.

The honoree directory

Open Charitable » Tributes » Honorees to see every honoree on your site. The directory is a searchable, filterable list with the numbers you care about in each row.

Each row shows:

  • The honoree’s name and photo.
  • Donations – the number of gifts made in their name.
  • Total raised – the running total.
  • Linked tributes – the tribute campaigns connected to this honoree.
  • Status – whether the record is published, a draft, or in the trash.

You can search by name, filter by the template used to create the honoree, and click any name to open the full record.

Inside an honoree record

Click an honoree to open their detail page. It brings together everything about the person and the giving made in their name.

Totals at a glance

The top of the record shows headline numbers: total raised, number of gifts, number of unique donors, and the most recent gift. These come from a cached totals table, so the page stays fast even for an honoree with hundreds of gifts.

The donations made in their name

A table lists every gift linked to this honoree, with the donor display name (respecting anonymous and family-only choices), the amount, the date, and the personal message. This is the giving history for that person in one place.

Family contacts

Family contacts are kept separately from donors, so you can reach a loved one directly without confusing them with the people who gave.

Add a contact with their name, email, postal address, and relationship to the honoree. You choose whether each contact is opted in to the family digest, the periodic summary of giving in their loved one’s name. Contacts can be edited or removed at any time.

Admin notes

Each record has a private notes area for your team, saved as you type. Use it for context that should not be public, such as how the family prefers to be contacted.

Privacy levels

Every honoree has a privacy level that controls who can see the tribute and its donor messages.

LevelWho can see it
PublicEveryone. The tribute page and donor messages are visible to all.
Family approvalMessages are held until a family contact approves them.
MembersOnly logged-in users on your site.
Private linkOnly people with the private link. The tribute is not listed publicly.

You set the default privacy level in Settings, and you can override it per honoree.

Merging duplicate honorees

Sometimes the same person ends up with two records, usually because donors spelled the name differently. The merge tool combines them into one.

Merging moves all of the source honoree’s donations, linked campaigns, and family contacts into the target record, then recalculates the totals. Pick the record you want to keep as the target, and the other is folded into it.

Custom fields

If the built-in honoree details are not enough, you can define your own. In Settings > Custom Fields, add fields for honorees and for tribute campaigns, such as “Section of the cemetery” or “Preferred charity.” Your custom fields appear on the records and are available as email tags.

Reports and the Honoree Leaderboard

The Reports tab turns your tribute giving into insight.

  • The Tribute Donations report lists tribute gifts, filterable by tribute type, template, status, and date range.
  • The Honoree Leaderboard ranks honorees by amount raised or by number of gifts, so you can see which tributes are resonating.
  • CSV export lets you download the donors and details behind any honoree or report for your records or a spreadsheet.

Tips

  • An honoree is created automatically the first time a gift is made in that name. You do not have to set them up in advance.
  • If two honorees look like duplicates, check the spelling of the name on the linked donations before merging, so you keep the cleaner record as the target.
  • Family contacts are never emailed unless you opt them into the family digest, so adding a contact for your records alone is safe.

Developer reference

The honoree model

Honorees are the charitable_honoree post type, enriched with these properties (see src/Models/Honoree.php):

PropertyMeaning
name, nicknameDisplay name and optional nickname.
dob, dodDate of birth and date of passing (ISO).
photo_attachment_idHonoree photo.
relationship_to_orgHow the honoree relates to your cause.
privacy_levelpublic, family-approval, members, or tokenized.
display_preferencefull or first-name-only.
entity_typeperson, pet, or cause (extensible).
family_approval_statusnot-required, pending, or approved.
tokenized_slugThe private-link token for tokenized privacy.
custom_fieldsAdmin-defined custom field values.

Custom tables

TablePurpose
wp_charitable_honoree_donationsOne row per gift, linked to an honoree (donor display, amount, message, status).
wp_charitable_honoree_family_contactsFamily contact records (name, email, postal, relationship, opt-in flags).
wp_charitable_honoree_totals_cacheCached totals per honoree (total raised, donor count, gift count).

Access them through the repositories rather than raw SQL:

use Charitable\Pro\Tributes\Repositories\Repositories;

$donations = Repositories::honoree_donations();
$contacts  = Repositories::honoree_family_contacts();
$totals    = Repositories::honoree_totals_cache();

AJAX endpoints

All require a nonce and the manage_charitable_settings capability.

ActionPurpose
charitable_tributes_save_honoree_notesSave the private admin notes.
charitable_tributes_save_custom_fieldsSave custom field definitions.
charitable_tributes_add_family_contactAdd a family contact.
charitable_tributes_update_family_contactUpdate a family contact.
charitable_tributes_delete_family_contactRemove a family contact.
charitable_tributes_honoree_mergeMerge two honoree records.
charitable_tributes_honoree_searchSearch honorees by name (used by autocomplete).

Events

The CRM emits actions you can hook into, including charitable_tributes_honoree_created, charitable_tributes_donation_linked, charitable_tributes_honoree_merged, and charitable_tributes_donation_refunded. See the full payloads in the Developer Reference.

Related

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 Improvement

📊 Your Pro Dashboard Can Now Compare, Export, and Score!

Most fundraising dashboards only tell you how much you have raised. Charitable Pro 1.8.19 rebuilds the dashboard and the Reports Overview around the harder questions: whether anything is broken, whether this period beat the last one, and which single change would make the most difference today. Why this is important:

  • 📈 Every figure has a trend: Pick a period and the tiles and the chart move together, with each total shown against the previous period.
  • 🗓️ Charts that stay readable: Short ranges group donations day by day, while longer ranges group by week or month, so a full year reads as a curve instead of a flat line.
  • 🔀 Compare any 2 periods: Not just consecutive ones, so you can ask how this December did against last December. That matters because fundraising is seasonal.
  • 📤 Export the whole summary: Send the full overview out as CSV or PDF, ready for a board pack or a funder report.
  • 🎯 Score your setup for free: Have your fundraising setup scored, so the one change worth making next is the one you can see.

Check out our announcement here.

Feature New

🎟️ Introducing Charitable Events: Sell Tickets Inside Your Campaigns!

Most nonprofits sell event tickets in one tool and collect donations in another, which leaves two sets of reports and a manual match at the end of the year. Charitable Events brings both together, selling tickets through the same donation forms and payment gateways you already run in Charitable. Why this is important:

  • 🎟️ Every ticket is a donation: Ticket sales run through the gateway you already use and count toward the campaign goal, with everything managed under Charitable » Events.
  • 📱 QR check-in from any phone: Each attendee gets their own QR code on the receipt, and volunteers scan at the door through a check-in link that needs no WordPress account.
  • 🧾 Receipts ready for tax time: Give each ticket type a fair market value, and Charitable puts the correct tax-deductible amount on every donor receipt.
  • 📋 Attendee details at checkout: Ask every guest for a meal choice, shirt size, or access needs, with a separate attendee record created for each ticket.
  • 🗓️ Blocks and calendars included: Three editor blocks plus Sugar Calendar and The Events Calendar support put your events where supporters already look.

Check out our announcement here.

ai New

🚀 Unleash AI Power in Charitable!

Your AI assistant can now build, edit, and manage your Charitable fundraising campaigns directly — just by asking. With Charitable Pro adding write support for the WordPress Abilities API, tools like ChatGPT, Claude, and Cursor can handle full administrative actions safely through MCP. Why this is important:

  • 🤖 Campaign creation in plain language: Prompt your assistant with a goal like “Set up a fundraiser for the shelter with a $5,000 goal”, and it builds a real draft campaign complete with suggested donation tiers.
  • 🎨 Instant donation form tweaks: Add custom fields, change button colors, or reorder elements without diving into form settings.
  • 📝 Offline gift logging: Tell your assistant about cash or check gifts, and it will match donor emails and record transactions into your history.
  • 🛡️ Safety and control by default: Write access stays strictly off until turned on in Charitable » Tools » AI MCP, keeping read-only reporting safe by default.
  • 📜 Full audit logging: Every change made by an AI assistant is tracked under Charitable » Tools » Logs, so you always know who (or what) updated your site.

Check out our announcement here.

Improvement Payments

💰 Accept Recurring Donations with Windcave and Charitable

A donor sets their gift up once on Windcave’s secure payment page, and Charitable bills every renewal after that on schedule. Why this is important:

🏦 Organizations banked in New Zealand or Australia: monthly giving on the gateway your bank already set you up with, with no second processor to onboard.
⛪ Churches taking regular tithes and offerings: congregants set their own schedule once, which is the simplest way to launch recurring church giving without a separate platform.
🌏 Groups with donors in several currencies: Windcave handles more than 20, so a supporter can give in the currency they actually hold.
📅 Operating funds rather than one-time campaigns: switch on Recurring Only mode and the one-off option disappears, so every gift to that campaign is a subscription.
🧾 Teams with no developer on staff: 3 sets of credentials pasted into a settings page, and no code anywhere.

Check out our announcement here.

automation update

⚡ Visual Automation Builder: Drag and Drop With No Code!

Charitable Automation Connect 2.3.0 introduces the Visual Automation Builder, a full-screen canvas that lays each automation out as a flow of connected cards: a trigger, optional conditions, and a list of actions that run in order.

🧩 Many actions, one trigger: Tag a donor, send an email, add a note, and fire a webhook from a single event, dragged into any order.

✉️ Act inside Charitable: New Send Email, Tag Donor, and Add Donor Note actions run with no external service required.

🔤 Merge tags: Personalize emails and notes with live fields like {first_name}, {total}, and {campaign_name}.

🔁 Apply to existing donors: Run Tag Donor and Add Donor Note against the donors you already have.

🖥️ Canvas or Simple: Switch views anytime, and automations built before 2.3.0 keep working unchanged.

Read more here.