Skip to main content

Using the new Control Panel? Dig into our new documentation

How to use smart fields

Smart fields make it easier than ever to personalize your emails. These fields use data from your NationBuilder database to dynamically populate text in your email content. Smart fields help personalize your message by crafting messages that feel 1:1, but can be created once and sent en masse. You can use smart fields to personalize the introduction to your blast, be specific in your fundraising ask by referencing the last amount someone donated or their year-to-date total, or send your supporters a personalized recruiter code to share with their networks.

Table of Contents

Using smart fields

Smart fields exist under the + Add dropdown menu in the Content tab of your email blast. To use smart fields:

1. Place your cursor where you'd like the smart field to be within your email content. Then, select + Add > Smart field.

2. A pop up box will appear with all the smart fields you can add to your email blast. Click on the one you wish to use.

3. Click Add smart field .

Your smart field will display within a grey box wherever your cursor was placed. You can repeat the process to add as many as you wish to an email blast. Make sure to click Save content when finished. 


How do I know if all the data exists in a smart field?

Filter for the data ahead of time and include ‘exists’ criteria in the field that you want to use as you are building out your list.

What if a recipient doesn’t have the data for the smart field I am selecting?

If the recipient doesn’t have the data for the smart field, it will either default to whatever exists (if it can’t be in a state with no data) or it appears as blank. The exception to this are a few methods that have a default set by the liquid (first name or friend, full name or friend). The best practice is to make sure the data exists before sending to your list. This can be achieved by filtering.

Smart fields currently available

What's the difference between smart fields and liquid?

Liquid is the underlying language that powers smart fields to work. Liquid is a templating language that makes it possible to add dynamic content. Liquid must be typed and formatted perfectly to work, as it is a programmatic language. So, smart fields make it easy by selecting the field you want from the dropdown menu, no typing or formatting is necessary!

Can I use smart fields with links?

Currently smart fields do not work in link or button URLs; however, you may use any of the Liquid variables found in the table below. In order to create a recruiter link, add ?recruiter_id={{}} to the end of the URL.

Do liquid conditionals work still?

Yes, using liquid in the content editor or in the template will still work as expected. No functionality is changing or being deprecated, we are only adding new functionality.

Below you'll find all of the smart fields that are currently available, as well as their liquid counterpart.

Smart field Liquid
First name or "Friend" {{ recipient.first_name_or_friend }}
Full name or "Friend" {{ recipient.full_name_or_friend }}
Prefix {{ recipient.prefix }}
First name {{ recipient.first_name }}
Last name {{ recipient.last_name }}
Email {{ }}
Phone number {{ recipient.phone_number }}
Mobile number {{ recipient.mobile_number }}
Employer {{ recipient.employer }}
Occupation {{ recipient.occupation }}
Precinct name {{ recipient.precinct_name }}
Social capital amount {{ recipient.social_capital_amount }}
Primary address  
Full address {{ recipient.address.one_line }}
Address 1 {{ recipient.address.address1 }}
Address 2 {{ recipient.address.address2 }}
Address city {{ }}
Address state {{ recipient.address.state }}
Address zip {{ }}
Total donation amount {{ recipient.donations_amount_format }}
Last donation amount {{ recipient.last_donation.amount_format }}
Donations year to date {{ recipient.donations_amount_ytd_format }}
Donations count {{ recipient.donations_count }}
Donation pledge amount {{ recipient.donations_pledged_amount_format }}
Fundraised pledge amount {{ recipient.donations_to_raise_amount_format }}
Fundraised amount {{ recipient.donations_raised_amount_format }}
Newest membership name {{ recipient.most_recent_membership_name }}
Newest membership status {{ recipient.most_recent_membership_status }}
Newest membership expiration date {{ recipient.membership_expires_at }}
Point person  
Point person full name {{ recipient.parent.full_name  }}
Point person phone number {{ }}
Point person email {{ }}
Public profile URL {{recipient.full_profile_url}}
Public profile settings URL {{recipient.settings_url}}
Recruiter code ?recruiter_id={{ }}
Recruits count {{ recipient.recruits_count }}
Primary site URL {{ }}
Unsubscribe URL {{ }}
Organization name {{ settings.official_name }}
Broadcaster name {{ }}
Broadcaster email {{ }}
Broadcaster phone number {{ broadcaster.phone_number }}

Related HOWTOs

Create an email blast

Showing 2 reactions

Wrap code snippets in <code></code> tags.
Please check your e-mail for a link to activate your account.

If you’re unclear on how this feature works, please ask a question. If you would like to see changes to this feature, please submit a suggestion.