Shortcodes & the form block

Three ways to put the donation form exactly where you want it.

The Donation Form block (recommended)

In the block editor, add the block named Donation Form (search "donation" or "donor"). You'll see a placeholder in the editor - the live form renders for visitors. The block accepts an optional heading shown above the form.

The shortcode

Anywhere shortcodes work - classic editor, widgets, page builders, theme templates via do_shortcode() - use:

[donor_merchant]

Add an optional title:

[donor_merchant title="Support our work"]

Show a campaign's form, its goal thermometer, or the donor portal:

[donor_merchant campaign="3"]
[donor_merchant_progress campaign="3"]
[donor_merchant_portal]

Settings → Shortcodes lists each one with your campaign IDs, and the Campaigns screen has a Copy button for each campaign's shortcodes.

Upgrading from 1.x?The legacy [donation_form] shortcode was removed in 2.4.0. Replace it with [donor_merchant].

In a theme template

<?php echo do_shortcode( '[donor_merchant]' ); ?>

What the form includes

  • Frequency choice (one-time, weekly, every 2 weeks, monthly, quarterly, yearly - you pick which) when recurring is enabled
  • Your suggested amounts plus an "Other" custom amount
  • Donor details (name, email, optional phone)
  • Optional dedication (in honor / in memory, with message)
  • Fee recovery checkbox with live total
  • Fund (designation) dropdown and your custom fields, if you set them up
  • An employer matching question and the UK Gift Aid declaration, if you switch them on
  • Payment method choice when more than one is on (Stripe, PayPal, offline gift)

Styling notes

For the common changes you don't need CSS: Settings → Forms → Form style sets the accent color (six swatches or your own, with a live preview) and the button shape (pill, rounded or sharp).

The form ships with clean, self-contained styles scoped under .dm-form, designed to sit well in any reasonable theme. To restyle it, add CSS targeting .dm-form in your theme or the Customizer's Additional CSS - your overrides win because the plugin's selectors are deliberately low-specificity.

Placement tips

  • Give the form its own page (e.g. /donate/) and link to it from your navigation - a dedicated page converts better than a form buried mid-article.
  • Keep the page distraction-free: headline, one paragraph of why, the form. See donation page best practices.

Get Donor Merchant

Free from WordPress.org. Card numbers never touch your site.

Download Donor Merchant free Or try the demo first.