Documentation Donations & Fundraising for WooCommerce

Donations & Fundraising for WooCommerce

Version 1.0.0 · Updated April 2026

Requirements

Before installing Donations & Fundraising for WooCommerce, please confirm your environment meets these minimum requirements:

For recurring donations, you will additionally need WooCommerce Subscriptions 3.0 or higher.

This plugin is tested against the latest stable releases of WordPress and WooCommerce and is HPOS (High Performance Order Storage) compatible.

Installation

Method 1 — Upload via WordPress Admin (Recommended)

  1. Download the plugin .zip file from your My Account downloads page.
  2. In your WordPress admin, navigate to Plugins → Add New Plugin.
  3. Click Upload Plugin at the top of the page.
  4. Click Choose File, select donations.zip, and click Install Now.
  5. Once installation completes, click Activate Plugin.

Method 2 — FTP Upload

  1. Unzip donations.zip on your local computer.
  2. Using an FTP client (FileZilla, Cyberduck, etc.), connect to your hosting server.
  3. Upload the extracted donations folder to /wp-content/plugins/.
  4. In WordPress admin, go to Plugins → Installed Plugins and click Activate next to Donations & Fundraising for WooCommerce.

Licence Activation

After activating the plugin, you must enter your licence key to receive updates and access support.

  1. Go to WooCommerce → Donations → Licence.
  2. Enter the licence key beginning with CA- from your purchase confirmation email.
  3. Click Activate Licence. A green success notice confirms activation.

Your licence key was emailed to you at time of purchase. You can also retrieve it from My Account → Orders on coreaddons.com.

Creating a Campaign

Each fundraising campaign is built around a standard WooCommerce product with donation-specific settings layered on top.

  1. Go to WooCommerce → Donations → Add Campaign.
  2. Enter a Campaign Name (this also becomes the product title displayed to donors).
  3. Write a Campaign Description explaining the fundraising purpose. This appears on the product page.
  4. Under Product Data, ensure the product type is set to Donation.
  5. Set the Campaign End Date if the campaign is time-limited. Leave blank for open-ended campaigns.
  6. Upload a Campaign Image via the standard featured image field — this appears as the product image and in widgets.
  7. Click Publish to make the campaign live on your store.

⚠️ Publishing the campaign product makes it immediately visible to customers. If you are still configuring amounts and goals, save it as a Draft until ready.

Donation Amounts

You can let customers enter any amount, offer preset buttons, or combine both approaches.

Fixed Preset Amounts

In the Donation Amounts tab of the campaign product, click Add Amount for each preset you want to offer. Enter a value and an optional label (e.g., "Feed a family for a week"). These render as clickable buttons on the product page. The customer clicks a button to select that amount and proceed to checkout.

Custom Amount Entry

Enable Allow custom amount to show a text field where donors can type their own figure. You can set a Minimum Donation and Maximum Donation to validate the entered value before it can be added to cart. Leave the maximum blank to allow any amount.

Combining Both

When both preset buttons and custom entry are enabled, preset buttons appear first followed by a "Custom amount" option that reveals the text field when selected.

Goal & Progress Bar

The fundraising goal tracks total donations received for a campaign and displays a visual progress bar on the product page.

  1. In the campaign product, open the Goal tab under Product Data.
  2. Enter the Target Amount (e.g., 5000 for a $5,000 goal).
  3. Enable Show Progress Bar to display the bar on the product page.
  4. Optionally enable Show Donor Count to display the number of individual donors.
  5. Enable Close campaign when goal is reached to automatically stop accepting donations once the target is met.

The progress bar updates in real time as new orders are completed. Only orders with status Completed or Processing count toward the total. Refunded orders are subtracted.

You can also display the progress bar anywhere using the shortcode [ca_donation_progress id="123"], where 123 is the campaign product ID.

Recurring Donations

Recurring donations allow supporters to commit to a weekly, monthly, or annual contribution, processed automatically via WooCommerce Subscriptions.

⚠️ Recurring donations require WooCommerce Subscriptions to be installed and active. Without it, this tab will not appear.

  1. In the campaign product, open the Recurring tab.
  2. Enable Allow recurring donations.
  3. Choose available billing periods: Weekly, Monthly, Annually (enable as many as you want).
  4. Optionally set a Subscription length — e.g., charge monthly for 12 months, then stop automatically.
  5. Optionally set a Free trial period — donors commit now but the first charge is delayed.

Donors see a "Make this a recurring donation" toggle on the product page. When enabled, they select their preferred billing frequency from a dropdown before adding to cart.

Display Options

Navigate to WooCommerce → Donations → Settings → Display to control how donation information appears to customers.

Shortcodes

Use these shortcodes to embed campaign elements anywhere on your site — pages, posts, sidebars, or theme templates.

[ca_donation_form id="123"]             — Full donation form for campaign ID 123
[ca_donation_progress id="123"]         — Progress bar only for campaign ID 123
[ca_donation_total id="123"]            — Total raised amount as plain text
[ca_donor_list id="123" limit="5"]      — Recent donor names list
[ca_campaign_grid]                      — Grid of all active campaigns
[ca_campaign_grid category="animals"]  — Grid filtered by campaign category

Replace 123 with your actual campaign product ID, found in the URL when editing the campaign (post=123).

Multiple Campaigns

There is no limit on the number of simultaneous campaigns. Each campaign is an independent WooCommerce product with its own goal, amounts, end date, and settings.

To keep campaigns organised, create a dedicated Donations product category and assign all campaign products to it. This lets you use the [ca_campaign_grid] shortcode to automatically list them on a dedicated fundraising page.

You can archive a campaign (stop accepting donations without deleting it) by setting its status to Draft or by setting an end date in the past.

Each campaign tracks its own goal and donor list independently. Donors who give to multiple campaigns appear in both lists.

Compatibility

Troubleshooting

Progress bar total is not updating

The total only counts orders in Completed or Processing status. Check that test orders have been marked as completed. Also go to WooCommerce → Status → Tools → Clear Transients and clear your caching plugin's cache.

Preset amount buttons are not appearing

Confirm the campaign product type is set to Donation (not Simple or Variable). Re-save the product and clear cache. Check that at least one amount has been saved in the Donation Amounts tab.

Recurring option is missing from the product page

Recurring donations require WooCommerce Subscriptions to be active. If Subscriptions is active but the option is still missing, confirm you have enabled Allow recurring donations in the Recurring tab and saved the product.

Donor names are not showing

Ensure Show donor names is enabled in WooCommerce → Donations → Settings → Display. Names only appear after at least one order with Completed status exists for that campaign.

Campaign is not visible on the shop page

Confirm the campaign product is Published and not set to a future date. If you want it excluded from the main shop loop and only accessible via direct URL or shortcode, enable Exclude from shop in the campaign settings.

Changelog

Version 1.0.0 — April 2026

Still need help?

Our support team responds within 24 hours on business days. Email us at support@coreaddons.com and include your site URL, licence key, and a description of the issue for the fastest response.

Contact Support