Charitable Documentation

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

Charitable Tributes: Pages and Blocks

Requires: 

  • Charitable Pro 1.8.16+
  • Charitable Tributes 1.0.0+

Every tribute campaign comes with its own page, and six purpose-built blocks let you make it beautiful without touching code. You can drop them onto the tribute page the wizard created, or onto any page or post on your site.

Where the blocks live

When you edit a tribute campaign in the block editor, you will find the Tributes blocks grouped under their own Tributes category in the block inserter. Tribute pages keep the inserter focused: only the Tributes blocks and core layout blocks (paragraph, heading, image, columns, and so on) are available, so it is easy to build a clean page.

You can also add any Tributes block to a normal page or post. Blocks that show data for a specific honoree have an honoree setting in the block sidebar, so the block knows whose information to display.

The six blocks

Honoree Card

Displays the photo, name, tribute label, and date range for an honoree. This is usually the top of a memorial page.

Options include the image shape (circle, rounded, or square), image size and alignment, and whether to show the photo, the tribute label, and the dates.

Tribute Goal Meter

Shows progress toward a goal, with the amount raised, the goal, and the donor count.

Options let you show or hide the donor count and goal, switch to a compact layout, and set the bar colors to match your design.

Tribute Donor Wall

Lists who gave, with privacy-respecting names and tribute messages. This is the social heart of a tribute page.

Options include a heading, the maximum number of entries to show, whether to show amounts, whether to include anonymous gifts, and the order (most recent or largest first). The wall automatically respects each donor’s anonymous and hide-from-honoree choices, so you never have to police it manually.

Personal Message

Highlights a message in a styled container, such as a few words from the family or your organization. The emphasis option offers a default, a serif, or a quote style.

Service Details

Shares memorial service details: date, time, venue, address, and an optional embedded map. Ideal for “in lieu of flowers” pages where attendees need the where and when.

Tribute Donate Button

Drops a clean call to action anywhere on the page, linked to the right donation form. The button can point at the honoree’s campaign or one you specify, and offers default, outline, and pill styles.

Block patterns

To save you from assembling a page block by block, Tributes ships with block patterns, pre-arranged layouts that combine these blocks into a ready-made tribute page. Insert a pattern, swap in your honoree, and you have a polished page in seconds.

The single tribute page

Each tribute campaign is published at a clean URL under /tribute/, for example https://yournonprofit.org/tribute/in-loving-memory-of-jordan/. The page renders the blocks you arranged in the editor. You can share that link with the family directly.

Embedding a tribute anywhere with the shortcode

To show a tribute somewhere other than its own page, use the shortcode:

[charitable_tribute id="123"]

Replace 123 with the ID of the tribute campaign. It renders the same block content the tribute page shows, so you can feature a tribute inside a blog post, a sidebar, or a landing page. The wizard gives you the exact shortcode for each campaign on its final step.

Tips

  • Start from a block pattern, then delete the blocks you do not need. It is faster than building from an empty page.
  • The Donor Wall updates itself as gifts come in. You do not need to edit the page when new donations arrive.
  • For a memorial with a service, the Service Details block plus a map embed answers the questions families get asked most.

Developer reference

Block names and key attributes

All blocks live under the charitable-tributes/ namespace and render server-side via a render.php file, so they always reflect current data.

BlockNameKey attributes
Honoree Cardcharitable-tributes/honoree-cardhonoreeIdshowPhotoshowLabelshowDateimageShapeimageSizeimageAlign
Donate Buttoncharitable-tributes/donate-buttonhonoreeIdcampaignIdlabelbuttonStyle
Goal Metercharitable-tributes/goal-meterhonoreeIdcampaignIdshowCountshowGoalcompactbarColor
Donor Wallcharitable-tributes/donor-wallhonoreeIdheadingmaxItemsshowAmountsshowAnonymousorderBy
Personal Messagecharitable-tributes/personal-messagecontentalignemphasis
Service Detailscharitable-tributes/service-detailsdatetimevenueaddressshowMapmapEmbedUrl

Restricting the editor

On tribute_campaign posts, the block inserter is limited to the Tributes blocks plus a curated set of core layout blocks. This is configured in the block registry. The honoree shown by a block is resolved server-side via the honoree data resolver, with a fallback filter:

add_filter( 'charitable_tributes_honoree_context_fallback', function ( $context, $block_attributes ) {
    // Provide honoree context when a block has no explicit honoreeId.
    return $context;
}, 10, 2 );

The shortcode

[charitable_tribute id="123"] renders the tribute_campaign post content. The single page template is templates/single-tribute_campaign.php, overridable in your theme. See the Developer Reference for the full block and template list.

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 →  

💸 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!

ambassadors New

👤 Creator Profiles: Put a Face to Every Peer-to-Peer Campaign

Ambassadors 3.3.0 now provies Creator Profiles — giving your supporters a permanent, shareable public home that turns one-time fundraisers into ongoing relationships.

👤 Public Creator Pages: Give every fundraiser an instant, clean landing page at /creator/their-name/ to showcase their custom avatar, bio, and a browsable grid of their campaigns.

📊 Proof of Impact: Boost donor trust by displaying site-wide milestones on the profile—like total funds raised and total donor counts.

💳 Interactive Hover Cards: When donors hover over a creator’s name on a campaign page, a compact card expands with their bio and social handles right at the moment of decision.

📍 Responsible Location Sharing: Allow creators to safely show local supporters where they are based using only city, state, and country details.

🛠️ Self-Serve Customization: Fundraisers can update their own profiles and link up to six social networks directly from the My Campaigns hub, saving you admin time.

Ready to empower your advocates? Update to Ambassadors 3.3.0 and turn on “Enable Public Creator Page” today!

Improvement Payments

📱 Turn Mobile Scrollers Into Donors: Meet Charitable’s Mollie Upgrade

Losing mobile supporters because they hate typing out long card numbers on their phones? Charitable’s updated Mollie integration features:

⚡ One-Tap Wallet Checkout: Enable donors to complete their gifts instantly using Apple Pay or Google Pay with a simple face scan, fingerprint, or tap.

💰 No Extra PCI Burden: Skip complex domain verification and security compliance since all wallet transactions run safely through Mollie’s hosted checkout.

🛠️ Custom Cancel Routing: Keep the experience predictable by automatically sending donors who back out to your cancellation page, or use developer filters to route them to a custom page.

Visit this page to learn more.

ambassadors improved New

Moderation and Directory Screens In Ambassadors 3.0

Ambassadors 3.0 has new features: moderation and directory screens… now easily see those who are earning donations on your peer to peer network – including campaign creators that might need to be verified – all in one place. Generate reports, email ambassadors and campaign creators directly and more.

🚀 See when campaign creators and ambassadors have updated their campaigns, what donors/donation they have brought in and more.

🎉 Manually add ambassadors and campaign creators, and approve them in one-click!

Visit this page to learn more.

New Payments

⚡ Unlock India-Based Donations: Meet Charitable’s Native Razorpay Integration

Trying to collect donations in India? Charitable’s native Razorpay integration features:

⚡ Instant UPI Integration: Accept fast, local donations directly inside your form via apps like PhonePe, Google Pay, Paytm, and BHIM without sending donors away from your site.

📲 Auto-Generated Campaign QRs: Instantly render scannable QR codes encoding a UPI deep link directly on your public campaign pages and sidebars for an effortless “scan-to-give” experience.

💰 Dual Local & Global Reach: Headline your campaigns in INR while seamlessly accepting major international currencies like USD, EUR, GBP, and CAD to maximize global support.

🔁 Seamless Recurring Giving: Fully integrates with the Charitable Recurring addon to manage automatic monthly subscriptions directly through Razorpay without extra code.

↩️ Automatic Two-Way Sync: Keep your books perfectly clean with two-way refund syncing—issue a refund inside WordPress or your Razorpay dashboard and both sides update automatically.

🔒 Webhook-Verified Security: Automatically protect your donation records using HMAC-signed webhook verification to ensure every status update represents real money cleared on the rails.

Visit this page to learn more.

Integration New

🎉 New Built-in PushEngage Integration

Struggling with falling email open rates and rising ad costs just to keep your supporters engaged? Charitable’s built-in PushEngage integration features:

🔔 Zero-Fee Direct Messaging: Deliver crisp, instant pop-up notifications straight to your donors’ desktops and mobile devices.

⏱️ Four Smart Automated Triggers: Automatically send updates for immediate donation thank yous, full-list campaign launches, urgent “ending soon” alerts, and goal milestone celebrations.

📈 Group Momentum Broadcasts: Turn private milestones into public wins by automatically broadcasting alerts to your entire subscriber list the moment a campaign hits 50%, 75%, or 100% of its goal.

📊 Automatic Analytics Tracking: Monitor exactly where your incoming notification traffic is coming from with built-in attribution that requires zero complex configuration.

Visit this page to learn more.