Complete Merge Tag Reference

Merge tags are placeholders in email content, confirmation pages, and page template HTML that DonorPoint replaces with actual values when content is rendered. Tags are written as #{TAG_NAME} or {TAG_NAME} (both forms are accepted).

Two types of dynamic content are available:

  1. Uppercase merge tags — #{DATE}, #{CONTACT}, etc. — resolved by substitution before EL evaluation
  2. EL expressions — #{contact.firstName}, #{purchaseOrder.amount}, etc. — evaluated as JSF Expression Language

This page documents the complete set of uppercase merge tags. See EL Expression Reference for EL expression syntax.

Transaction Merge Tags

Available in receipt emails, confirmation pages, and any email associated with a transaction.

Tag Resolves To
#{DATE} Transaction received date formatted as MM-dd-yyyy
#{DATETIME} Transaction received date and time
#{CONTACT} Donor full name
#{ADDRESS} Donor address as an HTML table
#{CAMPAIGNNAME} Campaign (form) name
#{ORDERTABLE} Full HTML order summary table: items, quantities, subtotal, fees, total
#{PAYMENT} Payment method details as an HTML table (confirmation from payment processor)
#{ORDER_NO} Transaction code / order number
#{UPDATEFORMTAG} HTML anchor link to the donor’s update/edit form
#{UPDATEFORMURL} URL to the donor’s update/edit form (for building custom links)
#{REFERRALURL} URL-encoded referral form URL (includes donor contact ID for referral tracking)
#{TELLAFRIEND} Tell-a-friend link
#{TELLAFRIENDSUBJECT} Tell-a-friend email subject line
#{TELLAFRIENDEMAIL} Tell-a-friend email body

Contact and User Merge Tags

Available in any email sent to or about a specific constituent.

Tag Resolves To
#{CONTACTFIRSTNAME} Recipient’s first name
#{CONTACTLASTNAME} Recipient’s last name
#{CONTACTEMAIL} Recipient’s email address
#{USER} Logged-in staff user’s full name (first + last)
#{USERFIRSTNAME} Logged-in staff user’s first name
#{USERLASTNAME} Logged-in staff user’s last name
#{USEREMAIL} Logged-in staff user’s email address
#{LOGINLINK} Smart login link — campaign-aware, engagement-type-aware; links to the correct login page for the recipient
#{ACTIVATIONLINK} Account activation link including the activation key; used in new account welcome emails
#{TEMPPASSWORD} Temporary password placeholder (legacy; returns “Your existing password” for security)

Account Merge Tags

Available in any email sent from a specific DonorPoint account.

Tag Resolves To
#{ACCOUNTNAME} Your organization’s account name
#{ACCOUNTIMAGE} Your organization’s logo as an inline base64 <img> tag
#{SIGNATURE} Your organization’s account name (alias for #{ACCOUNTNAME})

Campaign (Form) Merge Tags

Available in emails associated with a specific campaign (form).

Tag Resolves To
#{CAMPAIGNFORM} Campaign’s canonical public URL
#{CAMPAIGNFORMSHORTURL} Campaign’s short URL (brurl.co format)

Widget Merge Tags

Available in email templates and page template HTML.

Tag Resolves To
#{SOCIAL} Social sharing widget (SocialList.xhtml rendered inline) — includes email, Facebook, Twitter, etc.
#{DOUBLETHEDONATION} 360MatchPro employer match widget; requires 360matchpro_public_key account property configured
#{MAP} Map resource string

Community / Team Fundraiser Merge Tags

Available in community fundraiser and team campaign emails.

Community Level

Tag Resolves To
#{COMMUNITYNAME} Community fundraiser name
#{COMMUNITYGOAL} Community’s fundraising goal formatted as currency
#{COMMUNITYMISSION} Community’s description / mission statement
#{COMMUNITYLABEL} Configurable label for the community (e.g., “Community”, “Board”, “Fundraiser”)
#{COMMUNITYTEAMSNUMBER} Number of teams (or initiatives, board members) in the community
#{COMMUNITYDEADLINE} Community end/deadline date
#{COMMUNITYURL} Community’s canonical public URL
#{COMMUNITYTINYURL} Community’s short URL (brurl.co format)
#{COMMUNITYTOTALRAISED} Total amount raised by the community
#{COMMUNITYDONATIONREFERRALURL} Donation referral URL for the community (includes contact ID for referral tracking)
#{COMMUNITYINVITENEWLEADERSURL} URL to invite new team leaders or initiative leaders
#{COMMUNITYINVITEPARTICIPANTSURL} URL to invite participants (can choose to create or join a team)
#{INVITEJOINURL} URL for invitees to join a specific team (not create a new one)
#{CUSTOMREGISTRATIONURL} Custom registration form URL for the community
#{CUSTOMREGISTRATIONJOINURL} Custom registration URL with team join parameters

Team Level

Available when an email is sent in the context of a specific team.

Tag Resolves To
#{TEAMNAME} Team name
#{TEAMGOAL} Team’s fundraising goal
#{TEAMTOTALRAISED} Team’s total raised
#{TEAMURL} Team’s public page URL
#{TEAMTINYURL} Team’s short URL
#{TEAMREFERRALURL} Team’s donation referral URL (includes contact ID)
#{TEAMLABEL} Configurable label for teams (e.g., “Team”, “Initiative”, “Board Member”)
#{MEMBERURL} Donor’s personal fundraising page URL (member page if one exists; otherwise team URL)

Dynamic Tables

A special feature of DonorPoint email and page template HTML allows you to create EL-driven repeating table rows. Add data-value and data-var attributes to any <table> element:

<!-- Repeat a row for each donation order item -->
<table data-value="#{purchaseOrder.orderItems}" data-var="oi">
  <tr>
    <td>#{oi.fund.name}</td>
    <td style="text-align:right;">$#{oi.extendedPrice}</td>
  </tr>
</table>

The data-value attribute is an EL expression returning a list. The data-var attribute names the variable for each item in the loop. All EL expressions inside the <tr> template have access to the loop variable.

Advanced: EL in Email Content

After uppercase merge tag substitution, DonorPoint evaluates any remaining #{...} expressions as JSF EL. This means you can use the full EL expression language in email content:

Your gift of #{commonRenderer.formatAmount(purchaseOrder.amount)} 
#{purchaseOrder.amount gt 1000 ? 'qualifies you for our major donor program!' : 'makes a real difference.'}

See Advanced Customization using Scripting and EL Expression Reference for details.