SureDonation Smart Tags

Smart tags let you insert dynamic placeholders into donation messages and emails. When a donation is completed, SureDonation automatically replaces each tag with real donation data such as the donor’s name, donation amount, campaign details, payment information, and more.

For example:

Hi { donor_name}, 

Thank you for your { amount} donation to { campaign_name}!

Hi { donor_name}, 

Thank you for your { amount} donation to { campaign_name}!

After a donor completes their donation, it may appear as:

Hi Jane Doe, 

Thank you for your $50.00 donation to Clean Water Fund!

Hi Jane Doe, 

Thank you for your $50.00 donation to Clean Water Fund!

Smart tags help you personalize confirmation messages, automate donation receipts, and create dynamic communication without manual updates.

How to Insert Smart Tags

SureDonation provides built-in tag pickers throughout the plugin.

To insert a smart tag:

1. Open the relevant SureDonation setting.
2. Click Add Tag (rich-text editors) or ⋮ (plain text fields).
3. Select the smart tag you want to insert.
4. Save your changes.

SureDonation replaces the selected tags automatically when the content is displayed or sent.

Where You Can Use Smart Tags

Smart tags are available in the following areas:

Note: The available tags shown in the picker are optimized for that location. Some additional tags may still work when typed manually depending on the processor being used.

Confirmation Message

Confirmation messages appear immediately after a successful donation.

Navigate to:

Form Editor → Confirmation → Confirmation Message

Available tags:

Example

Thank you { donor_name}!

We received your donation of { amount} toward { campaign_name}.

{ donation_receipt}

Thank you { donor_name}!

We received your donation of { amount} toward { campaign_name}.

{ donation_receipt}

Email Notifications

Email notifications power donor receipts, admin notifications, and refund emails.

Navigate to: Form Editor → Email Notifications

Smart tags work in:

• Send Email To
• Subject
• From Name
• From Email
• Reply To
• Email Body

Donation Tags

General Tags

Example: Donor Receipt Email

Send Email To: { donor_email}

Subject: Thank you for supporting { campaign_name}

Email Body

Hi { donor_name},

Thank you for your contribution of { amount}.

Transaction ID: { transaction_id}

{ donation_receipt}

Send Email To: { donor_email}

Subject: Thank you for supporting { campaign_name}

Email Body

Hi { donor_name},

Thank you for your contribution of { amount}.

Transaction ID: { transaction_id}

{ donation_receipt}

Additional Supported Tags

The following tags are not shown in the email picker but are still processed in confirmation messages and emails when entered manually.

Offline Donation Instructions

Offline donation instructions are shown when donors select the Offline Donation payment method.

Navigate to:

Settings → Payments → Offline Donations → Instructions

Only these tags are supported:

Example:

Thank you for supporting { campaign_name}.

Please complete your donation using the instructions below.

Questions? Contact us at { admin_email}.

Thank you for supporting { campaign_name}.

Please complete your donation using the instructions below.

Questions? Contact us at { admin_email}.

Any unsupported tags entered here remain unchanged.

Complete Smart Tag Reference

* Supported when entered manually.

How Smart Tags Work

SureDonation uses two independent processors.

Email & Confirmation Processor

Processes all email notification fields and confirmation messages.

• Supports all donation and email smart tags.
• Missing values resolve to empty output.
• Additional manually entered tags are also supported.

Offline Instructions Processor

Processes only offline donation instructions.

Supported tags:

• { campaign_name}
• { site_title}
• { site_url}
• { admin_email}

Other tags are ignored.

HTML-Based Smart Tags

These tags output styled HTML content instead of plain text:

• { payment_status}
• { donation_receipt}

For best results:

• Insert them on their own line.
• Avoid wrapping them inside additional HTML.

Security & Escaping

All smart tag values are escaped before rendering to keep emails and page content safe.

SureDonation uses appropriate sanitization methods depending on output type, including:

• Escaped text
• Escaped URLs
• Safe HTML rendering

Extending Smart Tags (Developer)

Developers can add custom tags using the filter below:

add_filter(
	'suredonation_email_smart_tags',
	function ( $tags, $donation_data, $campaign ) {
		$tags['{donor_first_name}'] =
			explode( ' ', $donation_data['donor_name'] ?? '' )[0];

		return $tags;
	},
	10,
	3
);

add_filter(
	'suredonation_email_smart_tags',
	function ( $tags, $donation_data, $campaign ) {
		$tags['{donor_first_name}'] =
			explode( ' ', $donation_data['donor_name'] ?? '' )[0];

		return $tags;
	},
	10,
	3
);

Filter parameters:

• $tags – Current smart tag array
• $donation_data – Donation details
• $campaign – Campaign object

Custom values are automatically escaped before output.

Offline donation instructions do not support custom smart tags.