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!

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.

Integration updated

📬 Introducing Brevo for Charitable: Turn Donors into Subscribers Automatically

The moment a supporter makes a gift is when they are most engaged. With the new Brevo integration for Charitable, you can automatically turn those one-time donors into long-term subscribers without touching a single spreadsheet.

Simply collect donor consent right on your donation form and start your welcome series immediately.

What’s New:

🔄 Automated Subscriber Sync: New donors who opt in are added straight to your Brevo contact list as soon as their payment clears—no manual exports or CSV imports required.

🎯 Granular Consent & Opt-In Control: Customize your checkbox label, choose whether it defaults to checked or unchecked, or turn on Brevo double opt-in to keep your list clean and compliant.

📋 Per-Campaign List Mapping: Route supporters to your global email list or map specific campaigns to targeted Brevo lists to tailor your follow-up messaging.

⚡ 5-Minute Setup: Connect instantly by pasting your Brevo API key into the Newsletter settings, map your contact fields, and start building your email list on autopilot.

Ready to grow your mailing list? Brevo is available now starting on the Charitable Plus plan—connect your account today!

recurring donations updated

💳 Introducing Card Updates: Fix Expired Cards Without Losing Subscriptions!

newExpired or updated credit cards are one of the biggest silent leaks in recurring fundraising. With Card Updates in the Recurring Donations extension, donors can now refresh their payment details directly—keeping their subscription, schedule, and giving history completely intact.

No canceled plans, no lost history, and zero administrative headache for your team.

What’s New:

⚡ 30-Second Self-Service: Donors get a dedicated “Update Card” button in their dashboard that opens Stripe’s secure, PCI-compliant Customer Portal to update card details instantly.

🔒 Scoped & Safe Access: Scoped exclusively to card updates by default, donors can’t accidentally cancel or alter their plans from inside the portal, keeping your webhooks and data in sync.

🤝 Admin-Assisted Support: Helping a donor on the phone? Open their secure Stripe portal in one click from your admin screen or generate a single-use update link to email them.

📋 Automatic Audit Trail: Every payment method update is recorded automatically with a timestamp in both system-wide logs and the individual donor’s profile.

Ready to protect your recurring revenue? Get the Plus or Pro plan and update Recurring Donations to 2.3.0+ and enable “Update Payment Method” under your Settings today!

Integration page builder

Divi Fans Rejoice! Native Divi 5 Campaign Progress Bar Module!

With our new native Divi 5 module, you can anchor your microsites with real-time fundraising stats directly on the visual canvas. Here’s how it works, and why it’s worth turning on today.

Create campaign updates that are VISUAL AND LIVE. You can also:

📊 Campaign Progress Bar: Drop a live progress bar into any Divi 5 layout and show goal progress in real time.

🎨 Deep styling controls: Easily customize the bar and track color, height, and radius to match your brand perfectly.

👁️ Visual Builder ready: Configure and preview everything directly on the Divi canvas as a first-class module.

🔁 Identical rendering: The same exact engine powers this module, meaning consistent design without legacy shims.

✅ Faster launches: Never leave the Divi 5 interface to configure shortcodes or guess how your goal labels will look.

Learn more here.

Integration page builder

👉🏻 New in Charitable: Native Elementor Widgets for Seamless Campaign Building

With native Elementor widgets, you design donation campaigns right alongside the rest of your page without touching code. Here’s how it works, and why it’s worth turning on today.

Create fundraising pages that are VISUAL, NATIVE, AND SHORTCODE-FREE. You can also:

⚡ Mini Donation: Add a compact, high-converting donation widget with preset amounts and full color control.

⏳ Campaign Countdown: Build urgency for a deadline-driven appeal, complete with optional confetti when the goal is hit.

📣 Donation Feed: Prove momentum by showing visitors the social proof of real people giving right now.

🏆 Donor Leaderboard: Celebrate top supporters with gold, silver, and bronze styling to spark friendly giving.

🖼️ Campaign Showcase: Feature multiple campaigns in a landing page grid or carousel, with search, filters, and badges.

Learn more here.