Donations & Fundraising

Donations & Fundraising is a donation plugin for WooCommerce that turns any simple product into a donation campaign, with fixed amounts, a custom amount, a fundraising goal with a progress bar, and dedications. Donations go through your normal WooCommerce checkout, payment methods, and orders, so it suits stores, charities, and nonprofits that want to accept WooCommerce donations without a separate donation platform. View the product page.

Quick start

↑ Back to top

Create your first donation campaign in five steps:

  1. Go to Products > Add New and create a simple product, for example “Grower Relief Fund”. Tick Virtual and set Tax status to None in the General tab.
  2. Open the Donations & Fundraising tab in Product data and turn on Accept donations.
  3. In Donors can give, choose Both: fixed amounts plus “Other” and add a few fixed amounts, such as $10, $25, and $50.
  4. Optional: turn on Set a goal and enter a Goal amount.
  5. Select Publish and open the product page. The donation form replaces the Add to cart button.

The Start collecting donations checklist in WooCommerce > Settings > Donation & Fundraising tracks your setup: create a campaign, set amounts and a goal, show it on the cart, checkout, or a page, and make a test donation. When all four steps are done, it shows “Your store is ready for donations”.

Donations and Fundraising settings header with the completed setup checklist

Installation

↑ Back to top

To start using a product from WooCommerce.com, you can use the โ€œAdd to storeโ€ functionality on the order confirmation page or the My subscriptions section in your account.

  1. Navigate to My subscriptions.
  2. Find the Add to store button next to the product youโ€™re planning to install.
  3. Follow the instructions on the screen, and the product will be automatically added to your store.

Alternative options and more information at:
Managing WooCommerce.com subscriptions.

Requirements

↑ Back to top
  • WordPress 6.5 or later.
  • WooCommerce 8.5 or later.
  • PHP 7.4 or later.
  • A simple product for each campaign. Variable and other product types can’t be donation campaigns.

The plugin works with the Cart and Checkout blocks, the classic cart and checkout, High-Performance Order Storage (HPOS), and full-page caching. Donation amounts are converted with WooPayments Multi-Currency, WPML WooCommerce Multilingual, CURCY, and Aelia Currency Switcher. A wpml-config.xml file is included for translating settings texts.

Setup and configuration

↑ Back to top

You set up each campaign on its product, and the store-wide options in WooCommerce > Settings > Donation & Fundraising. The settings have five sections: General, Cart, Checkout, Round-up & fees, and Shortcode & block. The header links to the Donations report, the settings, this documentation, and support.

Campaign settings on the product

↑ Back to top

Open the product and go to the Donations & Fundraising tab in Product data.

Donations and Fundraising product tab with accept donations, donors can give, fixed amounts, and custom amount limits
  • Accept donations: Replace the Add to cart button of this product with a donation form. The donated amount becomes the price.
  • Donors can give: Fixed amounts you choose, Any amount they type, or Both: fixed amounts plus “Other”.
  • Fixed amounts: A Label and an Amount for each row. Select Add amount to add a row. Amounts are in your store currency.
  • Minimum amount and Maximum amount: Limits for a custom amount. Leave them empty to accept any amount above zero with no maximum.
Donation form settings on the product: how fixed amounts show, currency symbol, labels, button label, and dedications
  • Show fixed amounts as: Dropdown menu, Radio buttons, or Buttons.
  • Currency symbol: Show the currency symbol next to the custom amount field.
  • Symbol position: Before the amount or After the amount.
  • Amount field label, Amount field placeholder, and Button label: The texts of the form. The button label defaults to “Donate”.
  • Dedications: Let donors dedicate their gift “in honor of” or “in memory of” someone, with an optional message.
Campaign goal and causes settings on the product with goal type, goal amount, already raised, close on total, and closing message
  • Set a goal: Track progress toward a goal with a progress bar on the form. When the goal is reached or the end date has passed, the form closes and donations are refused.
  • Goal type: Amount raised, Percentage of the goal amount, Number of donations, or Number of days (date range).
  • Goal amount or Target number of donations: The target, depending on the goal type.
  • Already raised: Donations received offline or before this campaign, shown on the progress bar together with online donations.
  • Close on total: Count the already-raised amount toward the goal when closing the campaign. When it’s off, only online donations close it, and the bar still shows both.
  • Start date and End date: The campaign dates. The end date is inclusive, in your site’s time zone.
  • Closing message and Message: Show a message instead of the form once the campaign has closed.
  • Causes and Offer causes: Let donors choose what their donation supports, with an image, title, and description for each cause. The chosen cause is saved on the order.

Under the goal, Raised online so far shows the campaign total with a link to the report.

General

↑ Back to top
General settings with the donation form layout and after donating options
  • Layout: The order of the form sections: Layout 1: amounts, then causes, Layout 2: causes first, or Layout 3: custom amount before fixed amounts.
  • After donating: What happens after a visitor selects the donate button: follow the WooCommerce setting, Stay on the page and show a confirmation, Go to the cart, or Go to checkout. Donating on the cart or checkout page always stays on that page.

Live preview shows the form of a campaign with the selected layout, before you save.

Live preview of a donation form with amount buttons, custom amount, dedication checkbox, and progress bar
Campaign rules and data settings with coupons, start dates, campaign totals, and delete data on uninstall
  • Coupons: Coupons never discount donations.
  • Start dates: Refuse donations before a date-based campaign’s start date. Until then, the form shows “This campaign opens for donations on โ€ฆ”.
  • Campaign totals: Shows whether the running totals are up to date, with a link to recalculate them.
  • Delete data on uninstall: When the plugin is deleted, also delete its settings and the donation settings of products. Orders and their donation lines are never deleted.

Cart

↑ Back to top
Cart settings with enable, choose donations, and choose position
  • Enable: Show donation forms on the cart page.
  • Choose Donations: The campaigns to show. Type a name or ID.
  • Choose Position: Where the form shows. On the classic cart, it’s the exact position. On the Cart block, Before Cart, After Cart Table, and After Cart show the form below the cart items, and the other positions show it in the order summary.

Checkout

↑ Back to top
Checkout settings with enable, choose donations, and choose position
  • Enable: Show donation forms on the checkout page.
  • Choose Donations: The campaigns to show.
  • Choose Position: On the classic checkout, it’s the exact position. On the Checkout block, Before Checkout Form, Before Billing Form, and Before Shipping Form show the form after the contact details, After Checkout Form shows it in the order summary, and the other positions show it after the payment options.

Round-up & fees

↑ Back to top
Round-up spare change and donor covers the processing fees settings

Round-up “spare change”: donors can round their order total up and give the difference to a campaign. The round-up is a separate, tax-free fee line on the order and counts toward the campaign goal.

  • Enable: Offer a round-up at checkout.
  • Campaign: The campaign that receives the round-ups.
  • Round up to the next: $1, $5, or $10 (in your store currency).
  • Checkbox text: Optional. Use %1$s for the round-up amount and %2$s for the campaign name.

Donor covers the processing fees: when the cart contains a donation, donors can add a small amount to cover your payment provider’s fees. It’s a separate, tax-free fee line credited to the largest donation’s campaign.

  • Enable: Offer to cover the processing fees.
  • Percentage: A percentage of the donations in the cart.
  • Fixed amount: Added once per order, in your store currency.
  • Checkbox text: Optional. Use %s for the amount.

Shortcode & block

↑ Back to top
Shortcode settings with choose donations and the generated shortcode with a copy button
  • Choose Donations: Pick the campaigns, and the Shortcode below updates. Select Copy to copy it.

In the block editor and the Site Editor, add the Donation Form block instead.

Donation thank-you email

↑ Back to top

The plugin adds a Donation thank you email in WooCommerce > Settings > Emails. It’s sent to donors once an order with a donation is paid (processing or completed) and lists each donation with its cause and dedication. It’s off by default, so turn it on there. The default subject is “Thank you for your donation to {site_title}”.

Donation thank-you email listing the campaign, cause, dedication, and total donated

How-to guides

↑ Back to top

How to accept WooCommerce donations on a product page

↑ Back to top
  1. Open a simple product and go to Donations & Fundraising in Product data.
  2. Turn on Accept donations and choose what Donors can give.
  3. Add fixed amounts or set the custom amount limits.
  4. Select Update.
Donation form on a product page with amount buttons, a custom amount, a dedication option, and a progress bar

How to set a donation goal with a progress bar

↑ Back to top
  1. In the product’s Donations & Fundraising tab, turn on Set a goal.
  2. Choose a Goal type, for example Amount raised, and enter the Goal amount.
  3. Enter any offline donations in Already raised.
  4. Add a Start date and End date if the campaign runs for a set time.
  5. Turn on Closing message and write the message donors see when it closes.

The progress bar shows on every form of the campaign. Running totals update when orders are paid, refunded, or cancelled.

How to add a donation to the cart or checkout

↑ Back to top
  1. Go to WooCommerce > Settings > Donation & Fundraising > Cart (or Checkout).
  2. Turn on Enable and choose the campaigns in Choose Donations.
  3. Choose a Choose Position and select Save changes.
Block cart with a donation line and the donation form below the cart items

How to add a round up donation and let donors cover processing fees

↑ Back to top
  1. Go to WooCommerce > Settings > Donation & Fundraising > Round-up & fees.
  2. Turn on the round-up, choose the Campaign, and choose Round up to the next.
  3. Turn on Donor covers the processing fees and enter your provider’s Percentage and Fixed amount.
  4. Select Save changes.
Checkout with the options to cover the processing fees and round up the total for the campaign

How to show a donation form on any page

↑ Back to top
  1. In the block editor or the Site Editor, add the Donation Form block and choose the campaigns.
  2. Or copy the shortcode from Shortcode & block and paste it into any page, post, widget, or page builder text module, for example [donation_and_fundraising id="12,34"].

How to see how much each campaign has raised

↑ Back to top

Go to WooCommerce > Donations. Choose a Period and a Campaign, then select Apply. The report shows the amount raised (paid orders, refunds deducted, including round-ups and fees covered), the number of donations, the average donation, orders with a donation, a table per campaign with its goal, and the amount raised per day. Select Export CSV to download the data.

Donations report with amount raised, number of donations, average donation, campaign table, and amount raised per day

Video

↑ Back to top

Frequently asked questions

↑ Back to top

Can donors name their own price?

↑ Back to top

Yes. Choose Any amount they type or Both: fixed amounts plus “Other” in Donors can give, and set a minimum and maximum if you want limits.

Does it work with the Cart and Checkout blocks?

↑ Back to top

Yes. The donation form is a native inner block, and the Choose Position setting decides where it shows on the block cart and checkout.

Will the progress bar slow down my store?

↑ Back to top

No. Each campaign keeps a running total that updates when orders are paid, refunded, or cancelled. You can recount at any time in WooCommerce > Status > Tools > Recalculate donation goal totals.

Do coupons discount donations?

↑ Back to top

On new stores, no. Stores upgrading from 1.0.x keep the old behavior until you turn on Coupons never discount donations in General.

Can a charity or nonprofit use it for recurring donations?

↑ Back to top

Not yet. Donations are one-time payments, so monthly giving isn’t supported.

Are the emails tax-deductible receipts?

↑ Back to top

The thank-you email confirms each donation with its amount, cause, and dedication. Whether it qualifies as a tax receipt depends on your country and organization.

What happens to my data if I delete the plugin?

↑ Back to top

Nothing, unless you turn on Delete data on uninstall first. Orders and their donation lines are never deleted.

Troubleshooting

↑ Back to top

The donation form doesn’t show on the product

↑ Back to top

Check that Accept donations is on and that Donors can give is set. With Fixed amounts you choose, the form is hidden until you add at least one amount. The product must be a simple product.

Donors can’t donate

↑ Back to top

The campaign may be closed: the goal was reached or the end date has passed. If Start dates is on, donations are refused before the start date. Check the minimum and maximum amount too. When the minimum is higher than the maximum, both limits are ignored until you fix them.

The progress bar total looks wrong

↑ Back to top

Run WooCommerce > Status > Tools > Recalculate donation goal totals. Only paid orders count, and refunds are deducted.

Donors don’t get the thank-you email

↑ Back to top

Turn on Donation thank you in WooCommerce > Settings > Emails. It’s off by default.

Known limitations

↑ Back to top
  • In version 1.1.0, cause images show the WooCommerce placeholder image instead of the image you chose.
  • Donations are one-time only. Recurring donations aren’t supported.
  • Only simple products can be donation campaigns.

Developer notes

↑ Back to top

Shortcode

↑ Back to top

[donation_and_fundraising id="12,34"] shows the donation forms of the products with these IDs. Shortcode & block in the settings builds it for you.

Email templates

↑ Back to top

The thank-you email uses WooCommerce email templates. To change it, copy emails/donation-thank-you.php and emails/plain/donation-thank-you.php from the plugin’s templates folder to yourtheme/woocommerce/emails/ and yourtheme/woocommerce/emails/plain/.

Filters

↑ Back to top
  • wcdf_form_data ($data, $product_id): The data of a donation form.
  • wcdf_is_donation_open ($open, $product_id): Whether a campaign accepts donations.
  • wcdf_campaign_status ($status, $product_id): The campaign status.
  • wcdf_goal_progress ($progress, $product_id): The progress shown on the bar.
  • wcdf_goal_contribution_amount ($total, $item, $order): How much an order line adds to the goal.
  • wcdf_goal_totals_batch_size ($size): Orders per batch when totals are recalculated. Default 200.
  • wcdf_after_donate_redirect ($url, $action, $product_id, $context): Where donors go after donating.
  • wcdf_loop_button_text ($text, $product_id): The button text in product lists. Default “Donate”.
  • wcdf_load_frontend_assets ($load): Whether the form scripts and styles load on a page.
  • wcdf_donation_cart_price ($price, $amount): The donation price in the cart.
  • wcdf_amount_to_base and wcdf_amount_from_base ($converted, $amount, $active, $base): Currency conversion.
  • wcdf_order_amount_to_base ($converted, $amount, $order): Order amounts in the base currency.

Actions

↑ Back to top
  • wcdf_goal_totals_changed ($product_id, $total, $count): After a campaign’s running total changes.
  • wcdf_goal_totals_backfill_done ($state): After existing orders are counted.
  • wcdf_store_api_update_{action} ($data): Store API cart updates other than adding a donation, such as the round-up and covered fees.

Works great with

↑ Back to top

Support

↑ Back to top

Need help? Contact WooCommerce.com support for Donations & Fundraising. Include your WordPress, WooCommerce, and plugin versions and the campaign you’re testing.

Related Products

WooCommerce Subscriptions is a WooCommerce extension that lets customers subscribe to your products or...

Offer add-ons like gift wrapping, special messages or other special options for your products.

Use of your personal data
We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.