Charitable Documentation

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

How to Customize The Ambassador Dashboard: My Campaigns Page

Requires: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

My Campaigns is the page each ambassador lands on after they sign in – their personal dashboard for the fundraisers they’ve created. It’s where they see how much they’ve raised, edit a fundraiser, copy a share link, recruit new ambassadors (if Invitations is on), and pop into editing mode.

The page is rendered by a single shortcode ([charitable_my_campaigns]) and styled by the same template chooser as the Fundraiser Page – so a site running enhanced templates gets an enhanced My Campaigns; a site running legacy gets the legacy view.

The My Campaigns page from an ambassador's perspective, showing their fundraisers with progress bars and action buttons

When You’d Use It

  • Setting up onboarding – the Setup Wizard’s Pages step creates a /my-campaigns/ page automatically. Visit it once to confirm the shortcode rendered.
  • Tuning the layout – hide the thumbnail, hide the share button, default to “most raised” sort, etc. – all without touching code.
  • Adding to an existing page – if you already have an “Account” page, drop [charitable_my_campaigns] inside an existing section.

Where to Find My Campaigns in Ambassadors

In your WordPress admin, go to Charitable » Ambassadors » My Campaigns.

The sub-tab has two halves: a settings column on the left, a live preview of the visitor-facing page on the right. The preview updates as you toggle settings so you can see the effect without flipping browser tabs.

The My Campaigns settings sub-tab with the live preview pane on the right

The My Campaigns Settings

SettingDefaultWhat it controls
Show Search BarOnThe search input above the campaign list.
Show Sort DropdownOnThe sort dropdown above the list.
Default Sort OrderNewest FirstThe initial sort the page loads with. Options: Newest First, Oldest First, Most Raised, Closest to Goal, Ending Soon. Applies even if the dropdown is hidden.
Show Campaign ThumbnailOnThe featured image on each campaign card.
Show Progress BarOnThe fundraising progress bar on each card.
Show Share ButtonOnThe share button on each card.
Show QR CodeOnA “QR code” link in each row that opens a downloadable PNG of the fundraiser URL. Only renders if the global QR Codes toggle is enabled.

The preview pane includes a Populated / Empty state switcher so you can see how the page looks when an ambassador has fundraisers and when they don’t.

The Shortcode

The whole page is rendered by:

[charitable_my_campaigns]

It takes no required attributes. Drop it into any page or post; it shows the current user’s fundraisers, or an empty state if they have none.

Logged-out visitors see a “Please log in” prompt instead. The login link respects whatever login flow you’ve configured (Charitable’s built-in login screen by default).

What Renders When

The shortcode’s render depends on the UI version setting (Charitable > Ambassadors > General > UI Version):

UI versionWhat the page looks like
LegacyThe original 1.x rendering. Plain list, minimal styling.
EnhancedThe 3.0 rendering: card grid, modern layout, share menu, recruit card.
VisualSame as Enhanced for My Campaigns; the difference is only on the fundraiser pages themselves.

The settings sub-tab and live preview reflect whichever UI version you’re on. If you’re still on legacy, you’ll see a banner pointing you to the upgrade.

The Recruit Card

If Invitations is enabled and the signed-in user is eligible to recruit, a “Recruit Fundraisers” card appears at the top of the page above their campaign grid. The card has their personal invite URL, share buttons, a stats line, and a “Your Recruits” toggle.

See Invitations – Recruit Fundraisers with Personal Links for the full rundown.

Per-Campaign Actions

Each campaign card has a row of actions across the bottom:

ActionWhat it does
EditOpens the campaign in the Charitable visual builder (or the appropriate editor for the campaign’s UI version).
ShareOpens the share menu with the same social networks the fundraiser page itself uses.
DonationsIf the Creator Donations Report is enabled, lists every donation to this campaign.
QR CodeOpens a modal with a downloadable PNG of the fundraiser URL.
Recruit(Parent campaigns only) Opens a campaign-scoped invite URL popover.

Whether each action shows up follows the visibility toggles in the settings – hide the share button site-wide, and it disappears from every card.

Campaign Creator Donations Report

A long-running feature on My Campaigns: ambassadors can see and download a CSV of every donation to their fundraiser. The section lives at the bottom of the My Campaigns settings sub-tab (it was on the General sub-tab in 2.x, moved here in 3.0).

SettingDefaultWhat it controls
Allow Export of Donation HistoryOnWhether the Donations action button appears on each card.
Include personal details for anonymous donorsOffWhether anonymous donors are shown with their real name in the export (use only if your privacy policy allows).
Include child campaign donationsOffFor parent campaigns: roll up donations to underlying fundraisers in the export.

Theme Overrides

The whole template is overridable from your theme:

your-theme/charitable-pro/charitable-ambassadors/my-campaigns.php

The default template lives at wp-content/plugins/charitable-ambassadors/templates/my-campaigns.php. Copy it to your theme to make site-wide layout changes that survive plugin updates.

Tips

  • Keep search and sort on. Once an ambassador has more than 3-4 fundraisers, both controls become useful.
  • Default to “Most Raised” for established programs. New ambassadors should land on their highest-performing fundraiser first, not their oldest.
  • The empty state matters. Visit /my-campaigns/ as a user who has zero fundraisers and confirm the empty-state copy points clearly at your submission page.

Developer reference

The rest of this page is for developers customizing My Campaigns.

Shortcode

[charitable_my_campaigns]

Class: Charitable_Ambassadors_My_Campaigns_Shortcode. Display callback returns the rendered HTML directly. The output is filterable via charitable_my_campaigns_shortcode_output:

add_filter( 'charitable_my_campaigns_shortcode_output', function ( $html, $args, $atts ) {
    return $html . '<p>Need help? Email [email protected]</p>';
}, 10, 3 );

Settings storage

charitable_settings > ambassadors > my_campaigns_show_search
charitable_settings > ambassadors > my_campaigns_show_sort
charitable_settings > ambassadors > my_campaigns_default_sort
charitable_settings > ambassadors > my_campaigns_show_thumbnail
charitable_settings > ambassadors > my_campaigns_show_progress
charitable_settings > ambassadors > my_campaigns_show_share
charitable_settings > ambassadors > qr_codes_show_in_my_campaigns
charitable_settings > ambassadors > allow_creators_donation_export
charitable_settings > ambassadors > include_anonymous_donor_details
charitable_settings > ambassadors > creators_donation_export_include_child_campaigns

Read with charitable_get_option( 'my_campaigns_default_sort', 'newest' ).

UI version

charitable_ambassadors_ui_version() returns 'legacy', 'enhanced', or 'visual'. The shortcode renders the appropriate template based on this value. Force the value for testing:

add_filter( 'pre_option_charitable_settings', function ( $v ) {
    // ...inject ambassadors.ambassadors_ui_version into the option array.
} );

Filters

FilterDefaultPurpose
charitable_my_campaigns_shortcode_outputcomputed HTMLFilter the entire shortcode output before return. Receives ($html, $args, $atts).
charitable_ambassadors_my_campaigns_default_sortsetting valueOverride the default sort programmatically.
charitable_ambassadors_my_campaigns_show_searchsetting valueForce search visibility on/off.
charitable_ambassadors_my_campaigns_show_sortsetting valueForce sort dropdown visibility on/off.
charitable_ambassadors_my_campaigns_show_thumbnailsetting valueForce thumbnail visibility on/off.
charitable_ambassadors_my_campaigns_show_progresssetting valueForce progress-bar visibility on/off.
charitable_ambassadors_my_campaigns_show_sharesetting valueForce share-button visibility on/off.
charitable_ambassadors_my_campaigns_card_actionsarray of actionsModify the inline actions on each card. (Same action hook fires for both the page and the recruit-card flow.)
charitable_my_campaigns_query_argscomputedModify the WP_Query args used to fetch the current user’s campaigns.

Actions

ActionArgsFires when
charitable_ambassadors_my_campaigns_before_grid$campaigns, $user_idJust before the campaign grid renders. The recruit card mounts here when Invitations is enabled.
charitable_ambassadors_my_campaigns_after_grid$campaigns, $user_idJust after the grid. Use for an additional footer block.
charitable_ambassadors_my_campaigns_card_actions$campaign_id, $contextInside each campaign card’s action row.

Template

templates/my-campaigns.php                                           # Legacy
templates/my-campaigns-enhanced.php                                  # Enhanced + Visual

Theme override path: your-theme/charitable-pro/charitable-ambassadors/<filename>.php. The template chooser uses Charitable’s standard charitable_template_name + charitable_locate_template filters.

Capabilities

The shortcode renders for any logged-in user. There’s no admin capability gate – if you’re signed in, you see your own fundraisers. To hide My Campaigns from specific user roles, gate the shortcode at render time via charitable_my_campaigns_shortcode_output.

Customization examples

Always sort by Most Raised, regardless of setting:

add_filter( 'charitable_ambassadors_my_campaigns_default_sort', function () {
    return 'most_raised';
} );

Inject a “Start a New Fundraiser” CTA at the top of the grid:

add_action( 'charitable_ambassadors_my_campaigns_before_grid', function ( $campaigns, $user_id ) {
    $url = home_url( '/submit-campaign/' );
    echo '<p class="my-campaigns-cta"><a class="button" href="' . esc_url( $url ) . '">Start a new fundraiser</a></p>';
}, 10, 2 );

Hide the Share button from non-verified ambassadors:

add_filter( 'charitable_ambassadors_my_campaigns_show_share', function ( $show ) {
    $user_id = get_current_user_id();
    if ( '1' !== get_user_meta( $user_id, '_charitable_ambassadors_verified', true ) ) {
        return false;
    }
    return $show;
} );

Add a custom inline action (“Email Donors”) to each card:

add_action( 'charitable_ambassadors_my_campaigns_card_actions', function ( $campaign_id, $context ) {
    $url = add_query_arg( 'campaign_id', $campaign_id, home_url( '/email-donors/' ) );
    echo '<a class="my-campaigns-action" href="' . esc_url( $url ) . '">Email donors</a>';
}, 10, 2 );

Filter the campaigns shown to exclude charitable-rejected:

add_filter( 'charitable_my_campaigns_query_args', function ( $args ) {
    $args['post_status'] = [ 'publish', 'pending', 'draft' ]; // omit charitable-rejected
    return $args;
} );

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!

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.

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.