Overview
When to use it
While email blasts are often written so the content applies to all recipients, emails that have personalized content often have more impact, result in more actions taken and can increase donation amounts.
Turn this:
Into this:
And increase the open rates on your emails!
Note: For tools to individualize content based upon group membership, donation history, or actions taken read about dynamic content.
Merge Fields can be used in:
- The subject line of an email blast;
- The HTML body of an email blast; and
- The text body of an email blast.
How to get there
You have two options to insert merge fields into your email blast content.
- Simply type a field name wrapped in double square brackets in-line in the text - for instance, Dear
[[First_Name]]
- Use the dynamic content drop down list to automatically generate and insert the merge field.
Generating Supporter Merge Fields for Email Blasts


First_Name
is shown in this example.
Manually entering merge fields
- Find the appropriate field name
- Type it into your email content encased in double brackets.
[[First_Name]]
[[Last_Name]]
[[Street]]
[[Street_2]]
[[City]]
, [[State]]
[[Zip]]
-[[PRIVATE_Zip_Plus_4]]
Note: Since [[Street 2]]
will often be empty, it's best to place it on the same line as [[Street]]
to avoid an empty line break.
When the blast is sent, assuming values existed for those fields in the supporter's record, it would display for an individual supporter as something like:
Hot Tamale
491 Pepper Street Apartment 100
Las Salsas, TX 12345-0023
Troubleshooting Common Issues
[[First_Name]]
and it's received by a supporter for whom you do not have a First_Name value, Salsa will substitute a default value that you can configure in Default Merge Fields.Improperly formatted merge fields. Merge fields must have the [[ ]] syntax. They are also case-sensitive.
Misnamed merge fields. Custom fields will use the same double-bracket syntax as regular supporter fields; the field name within those brackets will be the API Name you assign to your custom field. You can see the API name for any custom field by examining the custom fields area under the Supporter Management tab.

Comments
When I am adding a simple field like, FIRST NAME, but I want to have a replacement word if that field is null, how do I do that? Something like, [[FIRST NAME]] [[if null then "Friend']]?
Hi Rebecca,
Great question! You can set that option in your account settings which you can read more about here: https://help.salsalabs.com/entries/21726850-Manage-Account
The page itself you'll configure is: https://help.salsalabs.com/entries/22545131-Default-Merge-Fields
The one thing to point out is that you can't do one-off changes - that is, for your Summer Fundraising Campaign, you can't have a separate set of default fields. The default fields will be set across your account.
On Legislator Info, I would like to have it segment down further so that an e-mail only goes to legislators of a certain party. I was trying something like these:
...but then I realized how lousy I am when it comes to figuring out how to script things! Can you point me to a resource that gives guidance on this. (I believe I have the partycode right, at least!)
Hi Joe -
This is a pretty unique/advanced request, so please email developers@salsalabs.com and they can get into more detail with you.
Thank you, Jake -- will do!
Can you change the format of a date field in an email blast, for instance instead of "2013-08-31" make it "August 31, 2013"?
Hi Jesse,
Unfortunately that is not an option at this time.
I am trying to put a PayPal pull-down button into an email blast, would this require Dynamic Content? When I try simply pasting the code from PayPal the buttons and logos only partly shows correctly...
Hi Russell,
Without seeing the code in front of me, it sounds like it's <form> code, which works inconsistently in email clients: http://www.campaignmonitor.com/blog/post/2435/
Emails don't allow for a lot of input / interactivity, so your challenge here may not be easily overcome. If you'd like, email support@salsalabs.com and they can take a look at your code and provide the best recommendation on the closet facsimile.
Hi,
I'm trying to dynamically include members of the House and Senate Appropriations committees based on the client's legislative district. It seems, though, that I can only filter by legislative district and/or state, not committee membership. Is that correct?
Thanks,
Doug Ward
Hi Doug,
Unfortunately, the "Dynamic Content" -> Legislator Info feature does not allow for filtering based on committee membership. That level of filtering is only available on Salsa action pages.
Hi Jake,
Is there a way to add the date of their last donation along with the amount?
Acasia Berry
Hi Acasia,
If you'd like to add the date of the donation into a donation receipt, you can use the merge field [[Transaction_Date]]
You can review this and other common merge fields in our related documentation.
Is there a way to add dynamic content based on "addressee" or "postal greating?" We have business supporters whose business name and employee contact is saved under those two fields.
Thanks,
Alex
Please sign in to leave a comment.