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 →  

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

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.