Charitable Documentation

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

Stats Shortcode

The [charitable_stat] shortcode allows you to display various Charitable statistics directly in a page. The statistics are dynamically calculated and displayed.

Note: The [charitable_stat] shortcode is only available in Charitable 1.6+.

Parameters

  • display: The type of data to display. The choices are:
    • total – The amount that has been raised. This is the default option.
    • progress – How much has been raised in relation to a goal. This will display a horizontal progress bar measuring the progress against a goal. Requires a goal parameter to be included too.
    • donors – The number of donors.
    • donations – The number of donations.
  • campaigns: A comma-separated list of campaign IDs. If not provided, all campaigns will be included. By default, this is empty (all campaigns are included).
  • goal: Required if display=progress. The goal that your progress is measured in relation to, without any currency symbols. By default, this is empty.
  • include_children: When set to true, includes donations from child campaigns (fundraisers, team member campaigns, etc.) when calculating statistics. This matches the behavior you see on campaign pages, where parent campaign totals automatically include child campaigns. Works recursively, including all descendants. Compatible with Charitable Ambassadors for team campaigns and fundraisers. By default, this is false.

Usage

Default. Show total $ raised in all campaigns

[charitable_stat]

Same as default. Shows total $ raised in all campaigns

[charitable_stat display=total]

Show total number of donors in all campaigns

[charitable_stat display=donors]

Show total number of donations in all campaigns

[charitable_stat display=donations]

Show total $ raised by all campaigns as a progress bar

[charitable_stat display=progress goal=100000]

Note: the goal parameter is required when display is set to progress.

Show total $ raised for a specific campaign including child campaigns

[charitable_stat display=total campaigns=304 include_children=true]

Show progress bar for a campaign including all fundraisers and team member campaigns

[charitable_stat display=progress campaigns=304 goal=10000 include_children=true]

Show number of donors including child campaigns

[charitable_stat display=donors campaigns=304 include_children=true]

Show number of donations including child campaigns for multiple campaigns

[charitable_stat display=donations campaigns=304,305,306 include_children=true]

Last Update: November 28, 2025

Still have questions? We’re here to help!

Last Modified: