Charitable Documentation

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

Creating Your First Campaign

Are you ready to create your first campaign (with a donation form) with Charitable? By following the step-by-step instructions in this walkthrough, you can easily create and publish your first campaign on your site in just minutes.

Before getting started, make sure you’ve installed and activated Charitable on your site.

Adding a New Campaign

To begin, you’ll need to be logged into your WordPress admin area. Once there, click on Charitable in the admin sidebar to go to the Campaigns page. Then, to create a new form, click on the Add New button to launch the Charitable campaign builder.

Add new campaign
Add new campaign

Selecting A Campaign Template

Now, you’ll come to the Select A Template screen. This is a library of premade templates and layouts that are neatly categorized in the left menu. You can use these filters or the search bar here to quickly find what you need.

Select a template

With Charitable, there are two general types of templates to choose from. For starters, Charitable has pre-built templates (that have basic components of a campaign page ready for you to customize and get you up and running as soon as possible.

If you would prefer to build your campaign entirely from scratch, select one of the “simple column” templates (all these do is provide the layout of the page – you add any fields manually).

Note: The campaign in this tutorial uses the Animal Sanctuary template. When you hover your mouse over the template, you’ll get an option to preview it to see how it looks and functions before getting started.

Hover back over the Animal Sanctuary template thumbnail and click Create Campaign to get started.

Customizing Your Campaign

Once you’ve selected a template, the campaign builder will open to the Fields Screen. This is where you can customize your campaign design.

Naming Your Campaign

One of the first things you should do is name your campaign to help you easily identify it later. You can type the name of the campaign in the text box at the top of the builder.

Enter a name for campaign
Dont forget to enter a name of the campaign at the top of the builder

Campaign Fields

The left panel will show you the possible fields you can add to your campaign. Some fields might not be available depending on what fields you have already added, your Charitable license, and extensions you have installed and activated.

The Fields are categorized into three types:

  • Recommended: These fields are highly recommended because they offer basic information or functionality of any campaign page. A green check mark means that at least once exists in your campaign page already.
  • Standard: Some standard fields (but not all) are often found on campaign pages and add additional functionality and information. For example, you add a Photo field, a Social Links field, or a generic HTML field to almost any custom HTML.
  • Pro: Majority of pro fields are available for users with an active license and with Charitable extensions installed and activated. These usually offer more functionality than standard fields – and can really make a campaign shine!

In the right panel, you will see an editable preview of your campaign.

To add a field to your campaign, you can drag and drop it directly into the campaign preview. To edit any text, simply click on the field in the form preview. An editing taskbar will open in the left menu where you can customize the content.

Similarly, you can click on any field such as the image, social sharing, and buttons to make changes. For instance, if you click on the image, editing options will open on the left where you can upload your own image to replace the one in the template.

To delete a field from your campaign, you can hover over it and click the trash can icon.

Accessing Field Options

Field options enable you to configure the details and settings of each field, such as its label and alignment.

To view and edit the options available for a field, click on it in the preview panel. The field options will then appear in the left panel of the campaign builder. Different fields will have different options, depending on what functionality they provide.

Field settings in Charitable
Settings Of The Campaign Description Field
Social field settings
Settings Of The Social Sharing Field

Editing Form Settings

To access your campaign’s settings, click on the Settings tab on the left side of the form builder. Here, you can add campaign goals, end dates, tags, and so much more. Let’s go through it step by step.

Setting A Campaign Goal

Set a campaign goal

To set the monetary goal of your campaign, visit the General Settings tab and you can input a number to represent the campaign goal (how much you desire the campaign to achieve). You can change this goal at any time, and you can also leave this goal blank if there is no goal (for example: you would like to collect as many donations as possible).

Setting A Campaign End Date

Ending date in campaign

In the same General Settings tab you can also set an end date for a campaign – a date that the campaign will automatically close and stop accepting donations.

Setting Donation Options

You can customize how the donation options on the donation form associated with your campaign by visiting the Donation Options tab. Here you can offer suggested donations (so users can 1-click to choose a donation amount). You can also decide if the user is able to enter a custom amount for a donation, along with setting a minimum amount for a donation.

Saving And Publishing Your Campaign

Save Charitable campaign

You can save your campaign at any time. Once you’re done configuring your campaign’s settings, click on the Save button at the top of the screen to save your changes.

You can edit and save changes while the campaign is in “draft” mode as much as you like. Once you have decided that it’s ready to make your campaign live change the status in the dropdown at the top of the page from Draft to Publish… and hit the Save button (if you have used WordPress before, this concept is similar to drafts/published blog posts).

Once your campaign is live you can view it by clicking View Live. Clicking this brings you to the URL of where the campaign lives by default – Charitable generates the page for you based on your WordPress theme.

View live campaign

Now that you are viewing the campaign page on the front-end of your WordPress site using your activated template you can go ahead and test the donation form by clicking on the Donate button that was already included in the campaign template.

Note: In this tutorial, we used the default WordPress theme Twenty Twenty. The appearance of your campaign will depend on your theme and any plugins that might affect the code and look of your website.

Here’s a sample of how the campaign will look once you

Preview campaign

Displaying Campaigns on Your Site

There are several different ways to add your campaigns to your site. We’ve already seen from the above that Charitable can generate the URL for you (and the donation page, if you have selected this in your General Settings).

Embedding A Campaign

Embed campaign

But Charitable gives you the flexibility to add campaigns using other methods. Once you’ve finished customizing your campaign, you can use the Embed Wizard right from the campaign builder by clicking the Embed button.

From here, you’ll have the option to either create a new page to embed your campaign on, or to select an existing page to add your campaign to.

Shortcode

You also have the option of getting the WordPress shortcode if you want to embed this campaign manually (especially useful for more custom WordPress sites, or if you are using a page builder like Elementor or Beaver Builder).

Campaign Block

Finally, in the WordPress editor, there’s a readymade Charitable block available. All you have to do is add a new block to your page or post and search for the ‘Charitable Campaign’ block. When you add it to your page or post, you’ll see a dropdown menu that lets you select which campaign you want to display.

Select Charitable Campaign As A Block To Embed A Campaign On Any WordPress Page

Congratulations!

That’s it! You now know how to create campaigns with Charitable.

Next, please be sure to test out your campaign. Check out our documentation section for answers to common questions and ways to further customize your Charitable campaigns and donation forms.

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 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.

Feature New

🎟️ Introducing Charitable Events: Sell Tickets Inside Your Campaigns!

Most nonprofits sell event tickets in one tool and collect donations in another, which leaves two sets of reports and a manual match at the end of the year. Charitable Events brings both together, selling tickets through the same donation forms and payment gateways you already run in Charitable. Why this is important:

  • 🎟️ Every ticket is a donation: Ticket sales run through the gateway you already use and count toward the campaign goal, with everything managed under Charitable » Events.
  • 📱 QR check-in from any phone: Each attendee gets their own QR code on the receipt, and volunteers scan at the door through a check-in link that needs no WordPress account.
  • 🧾 Receipts ready for tax time: Give each ticket type a fair market value, and Charitable puts the correct tax-deductible amount on every donor receipt.
  • 📋 Attendee details at checkout: Ask every guest for a meal choice, shirt size, or access needs, with a separate attendee record created for each ticket.
  • 🗓️ Blocks and calendars included: Three editor blocks plus Sugar Calendar and The Events Calendar support put your events where supporters already look.

Check out our announcement here.

ai New

🚀 Unleash AI Power in Charitable!

Your AI assistant can now build, edit, and manage your Charitable fundraising campaigns directly — just by asking. With Charitable Pro adding write support for the WordPress Abilities API, tools like ChatGPT, Claude, and Cursor can handle full administrative actions safely through MCP. Why this is important:

  • 🤖 Campaign creation in plain language: Prompt your assistant with a goal like “Set up a fundraiser for the shelter with a $5,000 goal”, and it builds a real draft campaign complete with suggested donation tiers.
  • 🎨 Instant donation form tweaks: Add custom fields, change button colors, or reorder elements without diving into form settings.
  • 📝 Offline gift logging: Tell your assistant about cash or check gifts, and it will match donor emails and record transactions into your history.
  • 🛡️ Safety and control by default: Write access stays strictly off until turned on in Charitable » Tools » AI MCP, keeping read-only reporting safe by default.
  • 📜 Full audit logging: Every change made by an AI assistant is tracked under Charitable » Tools » Logs, so you always know who (or what) updated your site.

Check out our announcement here.