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!

Improvement Migrations

↔️ Importing From GiveWP, Donorbox, GiveButter… even CSV!

Whether you’re migrating from another platform or consolidating your records, moving your data to Charitable is now faster and more flexible than ever. We’ve streamlined the process so you can bring over your entire fundraising history in just a few clicks.

🔄 Native GiveWP, Donorbox, & GiveButter Support: Switching from a major platform? Our dedicated migration tools handle the heavy lifting, automatically mapping your donors and donations directly into Charitable—no technical skills required.

📂 Universal CSV Import: Moving from a custom system or a specialized CRM? If you can export it to a CSV, you can import it here. Our smart mapping tool lets you align your columns to Charitable fields like names, emails, phone numbers, and addresses in seconds.

Instant Donor Profiles & Custom Tags: Automatically create rich donor profiles and bring in custom tags to keep your data organized. Segment and engage your supporters from day one with a clean, professional database structure.


Ready to make the switch?

Check out our GiveWP Migration Guide

Learn more about our Import Tools

Improvement Payments

💳 New Braintree Features For Your European Donors

With the release of Braintree addon version 1.3.0, you can now empower your European donors with the payment methods they trust and prefer, making giving seamless for international supporters.

🌍 Six New European Payment Methods: Support popular local options like iDEAL (Netherlands), Bancontact (Belgium), BLIK (Poland), and more to meet donors where they are.

⚡ Frictionless Donor Experience: These bank-based methods allow donors to authenticate directly with their own bank in a secure popup… no credit card numbers required.

⚙️ Automatic Currency Sync: No complex setup needed. The builder automatically displays the correct payment buttons based on your site’s currency (EUR or PLN), ensuring a relevant experience for every visitor.

Campaigns New

🖼️ Campaign Featured Images: Pro-Level Visuals Made Simple

With the new Campaign Featured Image setting in our visual builder, you now have a single, dedicated place to manage how your fundraisers look across your entire site and beyond.

🖼️ One Image, Everywhere: Set a primary thumbnail that automatically syncs to campaign grids, lists, and shortcodes—no more relying on layout order.

📱 Social Sharing Optimized: Easily upload images at the perfect size to ensure your campaigns look stunning and professional when shared on social media.

🔍 SEO & Accessibility Ready: Add custom alt text directly within the builder to improve search rankings and ensure your mission is accessible to every supporter.

Improvement receipts

🗓️ Annual Receipts 2.0: Send Year-End Receipts to Every Donor in Minutes

You can now send annual receipts in minutes with a few clicks to all your donors.

📧 One-Click Bulk Send Wizard that guides you to sending to hundreds of donors simultaneously directly from your WordPress dashboard.

🔍 Smart “Dry Run” Mode: See exactly who will receive a receipt and who will be skipped (and why) before a single email leaves your server.

🛡️ SMTP-Aware & Limit Protection: Charitable now detects your email setup and automatically adjusts batch sizes and pauses for daily limits to ensure your emails land in inboxes.

✅ Complete Audit Trail: Dedicated system log and on the individual donor’s profile, giving you a clear history for every fiscal year.

Stop dreading tax season and start spending that time on your mission. Update to Annual Receipts 2.0 and automate your year-end reporting today.

Addon Donations Improvement

🎈Recurring Donations 2.0: Smarter Automation, Better Recovery, and More Control

We’ve completely rebuilt our Recurring Donations system to help you grow your reliable income stream while giving you (and your donors) more powerful tools than ever before.

What’s New:

🔒 Recurring-Only Campaigns: You can toggle “Recurring Only” mode in the campaign builder to hide the one-time option entirely, ensuring your supporters stay focused on long-term commitment.

📧 Automatic Payment Recovery: Our new Payment Failed Email fires automatically the moment a subscription fails.

🛠️ Self-Service Donor Control:The new Cancel Subscription Button appears directly in the donor dashboard, allowing supporters to pause or end their recurring gifts on their own terms—reducing your admin burden and payment disputes.

📊 Real-Time Revenue Insights: Track your growth, monitor active subscriptions, and see exactly how much predictable support is coming in each month at a glance.

Our new Recurring Donations addon gives you the professional-grade tools you need to grow your mission.