Charitable Documentation

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

How To Use The Donation Form Visual Builder

The Donation Form Visual Builder is a powerful, easy-to-use drag-and-drop tool that lets you design custom donation forms directly within Charitable. It was created to simplify the process of building donation forms by giving you complete visual control over every field, section, and layout option – no coding required.

In this documentation, you will learn how to use all the available fields and configuration options to build donation forms that are unique to your campaign’s goals and style, helping you raise more efficiently and connect with your supporters better.

How to Use the Donation Form Visual Builder

Getting started with the Donation Form Visual Builder is simple and designed to fit into your existing Charitable workflow. Follow these steps to build and customize donation forms with ease:

Update Your Charitable Plugin

Make sure you have Charitable Pro version 1.8.8.10 or higher installed. The Donation Form Visual Builder is included out of the box in recent releases, so updating your plugin activates this new feature instantly.

Open or Create a Campaign

From your WordPress dashboard, navigate to Charitable » Campaigns. Open an existing campaign or create a new one to begin designing its donation form.

Add new campaign

Access the Visual Builder

Inside the campaign editor, you’ll find the new Form tab or section. Click to launch the drag-and-drop form builder interface.

form tab

Add and Arrange Fields

Drag required, standard, or Pro fields from the sidebar onto your form canvas. Use drag handles to rearrange fields in any order that fits your campaign goals and user experience preferences.

new donation form builder

Configure Field Settings

Click on any field to open its settings panel. Here, you can customize the label, placeholder text, help instructions, and whether the field is required. You can also set alignment and add custom CSS classes for styling.

Preview Your Form in Real Time

See your changes immediately in the live preview area. This ensures your form looks and flows exactly as intended before saving.

Save and Publish

Once you’re happy with the form design, save your changes. Your campaign donation form will be updated instantly and ready to accept donations.

Test Your Form

Always test the form on the front end to make sure it functions correctly across devices and payment gateways you have activated.

The Donation Form Visual Builder gives you total control, whether you want a quick setup with just the essentials or a highly customized form with advanced fields and messaging.

Form Fields Available in the Campaign Visual Builder

The Visual Builder offers a wide variety of fields categorized into Required, Standard, and Pro fields to give you full control over what information you collect and how your donation form looks and functions. Each field also includes common settings like custom labels, placeholders, instructions, alignment, and custom CSS classes for styling.

Required Fields

These essential fields are included in every donation form by default and cannot be removed because they are necessary to process donations securely and correctly:

  • Donor Name: Collects first and last names; mandatory. Layout toggle between stacked or side-by-side.
  • Donor Email: Required field for donor contact and receipt delivery; validated email input. Only one allowed per form.
  • Payment: Shows payment gateway options and payment inputs. You can select which gateways to activate and choose between classic text tabs or modern button styles.
  • Suggested Donation Amounts: Displays preset donation amounts configured at the campaign level with an optional custom amount input.
  • Address: Collects full postal address details, including street, city, state/province, postal code, and country.
  • Privacy Policy: Displays your site’s privacy notice, contact consent, and terms & conditions, configurable globally.

Standard Form Fields

Use these to collect additional data as suits your campaign:

  • Single Text Field: A basic single-line input for short text responses.
  • Dropdown Field: Allows donors to choose from predefined options; supports multiple selections.
  • Checkbox Field: Let donors select multiple items from a list.
  • Radio Button Field: Choose exactly one from a list of options.
  • Textarea: Multi-line input for longer comments or messages; configurable height and max length.
  • Email Field: Additional email address input with validation (different from the required donor email).
  • Phone Field: Phone number input optimized for mobile entry with validation.
  • Headline Field: Display-only text headings to organize form sections visually.
  • Number Field: Numeric input with configurable min, max, and step increments.
  • Date Field: Native browser date picker with optional time input and configurable min/max dates.
  • URL Field: Validated web address input, good for company URLs or team pages.
  • File Upload Field: Allow donors to upload files with configurable types, sizes, and cropping options.
  • Rich Text Editor: WYSIWYG editor to capture formatted text and media.
  • Picture Upload: Image uploader with drag & drop and preview thumbnails.
  • HTML Field: Insert custom HTML/CSS for static content or styling.
  • Shortcode Field: Render WordPress shortcodes dynamically within the form.
  • Hidden Field: Store information invisibly, useful for tracking sources or campaign data.

Pro Fields (Available With Charitable Pro)

Unlock powerful engagement and tracking capabilities with these advanced fields:

  • Donor Comment: Allow donors to leave public comments shown on the campaign page.
  • Referral Code: Collect and track referral or partner codes for attribution and affiliate programs.

Get More Information

Here are some of the more popular “how to” guides and help articles for you:

Want more fundraising tips and nonprofit advice?

We regularly share practical guides, proven strategies, and insider tips to help you raise more funds and build stronger donor relationships. Join thousands of nonprofits who get our best content delivered straight to them:

No fluff, just actionable advice from people who understand the challenges you face every day.

FAQs on the Visual Donation Form Builder

Do I need coding skills to use the Campaign Visual Builder?
No, the visual builder is designed for all users – whether you’re a beginner or an advanced user. You can drag, drop, and configure fields visually without writing any code. Optional custom CSS classes are available if you want to add your own styles.

Will my existing campaigns and forms work with the new builder?
Yes, all existing campaigns and donation forms will continue to work as before. You can open them in the Visual Builder to customize or enhance the form visually if you choose.

Can I use the builder to create multiple campaigns?
Absolutely. There’s no limit to how many campaigns you can create, each with its own unique form design and settings through the builder.

Are Pro fields available in the Visual Builder?
Yes. If you have Charitable Pro, you can add advanced fields like Donor Comments and Referral Codes, unlocking powerful engagement features.

How do I add the campaign form to my website pages?
After building and saving your form, use the embed wizard or shortcode provided in the campaign editor to place the form on posts, pages, or widgets seamlessly.

Can I preview the donation form before publishing?
Yes, the builder shows a live preview of your form, updating instantly as you make changes, so you always know exactly how it will look to donors.

What’s the difference between Charitable Lite and Pro? 

Charitable Lite is free but includes a 3% transaction fee. Pro plans eliminate this fee and include advanced features like recurring donations, donor management, peer-to-peer fundraising, and more payment gateways.

See Charitable Lite vs Pro »

Where can I get support if I have issues?

  • Free users: Use the WordPress.org support forums
  • Pro users: Contact support directly for priority assistance
  • Documentation: Check the comprehensive documentation library
  • Community: Join the newsletter and follow social channels for tips and updates

Are there video tutorials available? 

Yes! Subscribe to the Charitable YouTube channel for step-by-step tutorials and success stories.

Are you in need of support? Have a question? If you are a lite/free user of Charitable, you can reach out to our team on the WordPress.org support forums. If you have an active license, feel free to reach out to us directly for priority support.

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!

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.

Improvement Payments

💰 Accept Recurring Donations with Windcave and Charitable

A donor sets their gift up once on Windcave’s secure payment page, and Charitable bills every renewal after that on schedule. Why this is important:

🏦 Organizations banked in New Zealand or Australia: monthly giving on the gateway your bank already set you up with, with no second processor to onboard.
⛪ Churches taking regular tithes and offerings: congregants set their own schedule once, which is the simplest way to launch recurring church giving without a separate platform.
🌏 Groups with donors in several currencies: Windcave handles more than 20, so a supporter can give in the currency they actually hold.
📅 Operating funds rather than one-time campaigns: switch on Recurring Only mode and the one-off option disappears, so every gift to that campaign is a subscription.
🧾 Teams with no developer on staff: 3 sets of credentials pasted into a settings page, and no code anywhere.

Check out our announcement here.

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!