Charitable Documentation

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

How to Add a Custom Donation Field

Adding custom fields to your Charitable donation forms allows you to collect additional information from donors beyond the standard fields. Whether you need to gather referral codes, dedication messages, or specific donor details, you can easily add these fields using code snippets.

This guide will show you how to add custom fields in your donation forms.

In This Guide

Quick Start Example

Here’s a practical example to get you started. Check out this code snippet » Collect National ID.

This code snippet demonstrates how to add a National ID Number field to your donation form:

You can use that code snippet and customize it to suit your needs:

  • Replace every instance of ‘national_id_number’ with ‘your_field’.
  • Replace every instance of ‘National ID Number’ with the label for your field.

Now that you have an idea of code snippets, let’s show you how to add and customize code snippets.

How To Add A Code Snippet

If you are new to PHP or WordPress development, we recommend using the WPCode plugin to insert snippets safely and easily into your website. Charitable currently has over 130 snippets in the WPCode plugin library you can use. Visit our library here:

Charitable Code Snippet Library »

For those a little more familiar with WordPress development, you can use the snippets to create simple standalone plugins. Read the WordPress documentation about creating a plugin.

Alternatively, you could add the snippets directly to your theme or child theme’s functions.php file.

Please be aware of our recommendations and suggestions for safe practices using code snippets to avoid fatal errors and issues: Customizing Donation Forms With Code Snippets Using WPCode »

There are many other snippets that go beyond creating a text box on a donation form and extend into customizing your campaigns and donation forms even further. Feel free to explore the library either on WPCode‘s website or in the screen in the Charitable plugin.

Have an idea for a code snippet that doesn’t exist yet? Contact us and we’ll add it!

You may also be interested in WPCode documentation to learn more about how their plugin works and the additional features that you can assign to code snippets, including Charitable code snippets.

Get Fundraising Tips & Non-Profit 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: Adding Custom Fields to Charitable Donation Forms

What are custom fields and why would I need them? 

Custom fields allow you to collect additional information from donors beyond the standard name, email, and donation amount. Common uses include:

  • Collecting referral codes or promotional codes
  • Adding “In memory of” or dedication fields
  • Gathering feedback on how donors heard about your campaign
  • Including checkboxes for newsletter subscriptions
  • Adding company information for corporate donors

Do I need coding experience to add custom fields? 

No. While custom fields can be added through code, WPCode provides a user-friendly solution that doesn’t require any programming knowledge. You can install pre-built snippets with just a few clicks.

Will adding custom fields affect my donation conversion rates? 

This depends on implementation. Optional fields typically have minimal impact, while too many unnecessary required fields may possibly reduce conversions. We recommend:

  • Making additional fields optional when possible
  • Keeping forms concise and user-friendly
  • Testing different configurations to see what works for your audience

Is WPCode free to use? 

Yes! WPCode offers a free version that includes access to many code snippets. There’s also a premium version with additional features, but the free version is sufficient for most custom field needs.

Will custom fields work with my WordPress theme? 

Custom fields should work with any properly coded WordPress theme. However, you may need to add custom CSS to match your theme’s styling. If you experience display issues, contact our support team.

How do I install WPCode?

  1. Go to Charitable → Tools → Code Snippets
  2. If WPCode isn’t installed, you’ll see an installation prompt
  3. Click the install button to automatically install and activate WPCode
  4. Once activated, you’ll see available code snippets

I don’t see the Code Snippets tab. What’s wrong? 

This usually means:

  • Your Charitable version is outdated (update to 1.8.1.7+)
  • You don’t have admin permissions
  • There’s a plugin conflict (try deactivating other plugins temporarily)

How do I find the right code snippet for my needs? 

Use the search functionality in the Code Snippets tab. Search for terms like:

  • “text field” for additional text inputs
  • “checkbox” for opt-in options
  • “dropdown” for selection menus
  • “textarea” for longer text inputs

Can I modify the code snippets? 

Absolutely! Most snippets include comments and documentation to guide customization. You can change:

  • Field labels and descriptions
  • Field positioning on the form
  • Whether fields are required or optional
  • Field types (text, textarea, dropdown, etc.)

Where do custom field submissions appear? 

Custom field data appears in:

  • Donation details in your WordPress admin
  • Email notifications (if configured)
  • Export reports (if enabled in the snippet settings)

Can I add multiple custom fields to one form? 

Yes! You can install and activate multiple code snippets to add several custom fields to your donation forms.

Are there video tutorials available? 

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

Need 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 and our team will respond in a timely fashion. If you have an active license, feel free to reach out 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!

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.