Charitable Documentation

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

Creator Profiles in Ambassadors Addon

Creator Profiles give every campaign creator and fundraiser a shareable public page at /creator/your-name/, showing their avatar, bio, organization, social links, campaigns, and headline totals. Creators manage their own profile from the My Campaigns hub, and their identity now travels with them onto every fundraiser page.

Available in Charitable Ambassadors 3.3.0+ (requires Charitable Pro 1.8.16 or later).

Key Features

  • Publish a public profile page for each creator at /creator/<name>/, served automatically with no page to build.
  • Let creators edit their own profile from a new Profile tab in the My Campaigns hub: name, bio, organization, website, six social networks, photo, and location.
  • Show a creator’s avatar and an accessible hover card (bio, organization, social links, and a link to their public profile) next to their name on every fundraiser page.
  • Choose exactly which stats and sections appear on the public page, from bio and social links down to total raised, donor count, and an optional QR code.
  • Control location sharing responsibly: city, state, and country only, never a street address, with Disabled, creator-controlled, and forced modes.
  • Add a Share button (Copy Link, Share Via, Email) so creators can promote their profile in one click.
  • Embed any creator’s profile anywhere with the [charitable_creator_profile] shortcode.

Why Use Creator Profiles?

A fundraiser is often a one-time page with no lasting home for the person behind it. Creator Profiles give your most active supporters a recognizable identity across your site, so donors can see who they are supporting, browse their campaigns, and trust the person asking. That recognition builds credibility, encourages repeat fundraising, and turns individual campaigns into an ongoing relationship.

See It In Action

Nonprofit profile: Paul Cannon with avatar, organization, location, bio, and fundraising stats for the page

Requirements

  • Charitable Ambassadors 3.3.0 or later
  • Charitable Pro 1.8.16 or later
  • WordPress 5.0 or later, PHP 7.4 or later
  • Pretty permalinks enabled (Settings > Permalinks set to anything other than Plain), since the public page uses a rewrite rule

Getting Started

Activation

  1. In WordPress admin, go to Charitable > Ambassadors > Templates > My Campaigns.
  2. Find the Public Creator Page section and turn on Enable Public Creator Page.
  3. Save your settings. Each creator’s page is now live at /creator/<their-username>/.

When the setting is off, creator pages return a 404 and no profile content is exposed. Author archives are unaffected either way.

If pages return a 404 after enabling the feature, visit Settings > Permalinks once and save to flush the rewrite rules.

How Creators Edit Their Profile

Creators manage their own profile from the Profile tab inside the My Campaigns hub (the page that hosts the [charitable_my_campaigns] shortcode). From there a logged-in creator can set:

  • First and last name (used to build the display name)
  • Bio
  • Organization
  • Website plus Twitter / X, Facebook, Instagram, LinkedIn, YouTube, and TikTok
  • Profile photo
  • City, state, and country, and which of those to share (when location sharing is creator-controlled)

Administrators can edit the same profile fields for any creator from the Directory.

Public profile form with name fields, circular profile photo uploader, and social links.

The Public Creator Page

The page is served automatically at /creator/<name>/, where <name> is the creator’s WordPress user slug. The default creator base can be changed with a filter (see Developer Resources). The page can include the creator’s avatar, chosen name format, bio, organization, social links, a Share button, an optional QR code, a grid of their published campaigns, and headline totals.

Only published campaigns are counted and shown. Private, draft, pending, and rejected campaigns never appear.

Fundraiser Page Enrichment

On every fundraiser page, the creator’s name is enriched with a small avatar and an accessible hover and focus card. The card shows the creator’s bio, organization, and social links, plus a link to their full public profile. This is on by default and can be tuned or disabled with filters.

Fundraiser header showing Paul Cannon's profile on the left, a sunset beach photo in the center, and a donation panel with progress bar on the right for 'Paws and Claws Rescue Drive'

Location Sharing

Location sharing is limited to city, state, and country. A street address is never collected or shown. You control it site-wide with two settings:

  • Location Sharing Mode decides whether location is off, creator-controlled, or forced on.
  • Allow decides which parts (city, state, country) are eligible at all. An unchecked part is never shown, even in forced mode.

In creator-controlled mode, each creator opts in to the parts they want to show from their Profile tab.

Usage

Shortcode

Use the shortcode to embed a creator profile on any page or post:

[charitable_creator_profile user_id="12"]

or

[charitable_creator_profile nicename="jane-doe"]

With no attributes, the shortcode resolves the creator for the current /creator/<name>/ request, which is how the automatic page renders.

Shortcode Parameters

ParameterTypeDefaultDescription
user_idinteger0The WordPress user ID of the creator to display. Takes priority over nicename.
nicenamestring“”The creator’s user slug (nicename). Used when user_id is not supplied.

Configuration Options

All settings below live under Charitable > Ambassadors > Templates > My Campaigns.

Charitable plugin settings page showing the Public Creator Page section with a toggle and descriptive text for each option.

Public Creator Page Display

SettingTypeDefaultDescription
Enable Public Creator PagecheckboxOffMaster switch. When off, creator pages return a 404.
Show Creator NameselectFirst & Last NameWhich form of the name to show: First Name Only, Last Name Only, First & Last Name, or Username. The name is always shown; this only chooses the form.
Show BiocheckboxOnShow the creator’s bio.
Show OrganizationcheckboxOnShow the creator’s organization.
Show Social LinkscheckboxOnShow the creator’s social links.
Show Share ButtoncheckboxOnShow a Share button (Copy Link, Share Via, Email).
Show CampaignscheckboxOnShow the creator’s campaigns grid.
Show Total RaisedcheckboxOnShow the creator’s total amount raised.
Show Donor CountcheckboxOnShow the creator’s donor count.
Show Donation CountcheckboxOnShow the creator’s donation count.
Show Average DonationcheckboxOffShow the creator’s average donation amount.
Show Active Recurring CountcheckboxOffShow the creator’s active recurring donor count.
Show QR CodecheckboxOffShow a QR code linking to the creator’s public page, floating in the upper right.

Location Sharing

SettingTypeDefaultDescription
Location Sharing ModeselectDisabledDisabled (never show location), Allow Creator To Control, or Force (creator cannot change).
Allowmulti-checkboxnoneWhich parts creators can share: City, State, Country. Unchecked items are never shown, even in force mode.

Customization

Template Override

Copy the profile template into your theme to customize the public page layout:

yourtheme/charitable/charitable-ambassadors/creator/profile-page.php

Filters and Functions

Every display toggle, the URL base, the name format, and the fundraiser-page treatment can be adjusted in code. See Developer Resources below.

Troubleshooting

Creator pages return a 404

Confirm Enable Public Creator Page is on. Then visit Settings > Permalinks and save once to flush the rewrite rules. Also confirm the creator has at least one published campaign, since a profile with nothing published does not resolve.

A creator’s location is not showing

Location Sharing Mode must be set to Allow Creator To Control or Force, and the relevant part (city, state, or country) must be checked under Allow. In creator-controlled mode, the creator also has to opt in to that part from their Profile tab.

Social links are not appearing

Confirm Show Social Links is on and that the creator has entered at least one link in the Profile tab.

The profile photo is not updating

The public page uses the creator’s uploaded profile photo (the avatar user meta). The uploaded image must belong to that creator’s own media. If no photo is set, the site falls back to the standard avatar.

Developer Resources

Hooks and Filters

  • charitable_ambassadors_creator_slug — Filters the URL base for creator pages. Default creator.
  • charitable_ambassadors_creator_url — Filters the full public profile URL for a creator.
  • charitable_ambassadors_creator_name_format — Filters the resolved name format (firstlastfullusername).
  • charitable_ambassadors_creator_page_enabled — Filters whether the public page is enabled.
  • charitable_ambassadors_creator_page_show_{key} — Per-section visibility, where {key} is bioorgsocialsharecampaignsraiseddonorsdonationsavgrecurring, or qr.
  • charitable_ambassadors_creator_location_mode — Filters the location sharing mode.
  • charitable_ambassadors_creator_location_allow_{part} — Per-part location allowance, where {part} is citystate, or country.
  • charitable_ambassadors_creator_social_fields — Adds or removes editable social fields.
  • charitable_ambassadors_creator_avatar_meta_key — Filters the user meta key used for the profile photo. Default avatar.
  • charitable_ambassadors_creator_treatment — Enables or disables the creator avatar and hover card on fundraiser pages.
  • charitable_ambassadors_creator_inline_avatar — Toggles the inline avatar next to the creator’s name on fundraiser pages.
  • charitable_ambassadors_creator_tooltip — Toggles the hover and focus card on fundraiser pages.
  • charitable_ambassadors_creator_tooltip_show_{key} — Per-item visibility inside the hover card.
  • charitable_ambassadors_directory_creator_profile_tabs — Filters the tabs shown on the admin Directory creator profile.
  • charitable_ambassadors_creator_profile_saved — Action that fires after a creator profile is saved. Receives the user ID and the saved data array.

Useful Functions

  • charitable_ambassadors_get_creator_slug() — Returns the sanitized URL base for creator pages.
  • charitable_ambassadors_get_creator_url( $user_id ) — Returns the public profile URL for a creator.
  • charitable_ambassadors_creator_public_name( $creator ) — Returns the creator’s display name in the configured format.
  • charitable_ambassadors_creator_page_enabled() — Returns whether the public page is enabled.
  • charitable_ambassadors_creator_location_mode() — Returns the current location sharing mode.
  • charitable_ambassadors_creator_location_allows( $part ) — Returns whether a location part is allowed.
  • charitable_ambassadors_creator_social_fields() — Returns the editable social field definitions.

Additional Resources

  • [PLACEHOLDER: My Campaigns documentation URL]
  • [PLACEHOLDER: Charitable Ambassadors overview documentation URL]
  • [PLACEHOLDER: Fundraiser Page settings documentation URL]

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.