Table of Contents

Where to start

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.

Use smart fields to personalize your blast's intro, be specific in your fundraising ask by referencing the last amount someone donated, or send your supporters a personalized recruiter code to share with their networks.

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

📌 Note: When using smart fields in links (e.g. recruiter links), you will need to hyperlink the URL with the liquid variable. For example{{}}. Full list of liquid variables for each smart field are below.

Using smart fields

Within the Content area of an email blast:

1. 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 in your email content. 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).

Check out all the blank state fields. 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 allowing you to simply select the field you want from a dropdown menu, no typing or formatting is necessary!

Below you'll find all of the smart fields that are currently available through the menu, and the liquid variable they output "under the hood".  

Recipient info

Smart Field

Liquid variable

First name or "Friend"


Full name or "Friend"



{{ recipient.prefix }}

First name

{{ recipient.first_name }}

Last name

{{ recipient.last_name }}


{{ }}

Home phone

{{ recipient.phone_number }}

Mobile phone

{{ recipient.mobile_number }}


{{ recipient.employer }}


{{ recipient.occupation }}

Precinct name

{{ recipient.precinct_name }}

Social capital amount


Recipient Primary Address

Smart Field

Liquid variable

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

{{ }}


Smart Field

Liquid variable

Total donation amount


Last donation amount


Donations year to date


Donations count

{{ recipient.donations_count }}

Donation pledge amount


Fundraised pledge amount


Fundraised amount



Smart Field

Liquid variable

Newest membership name


Newest membership status


Newest membership expiration date


Point person

Smart Field

Liquid variable

Point person full name

{{ recipient.parent.full_name }}

Point person phone number:

{{ }}

Point person email

{{ }}

Public profile

Smart Field

Liquid variable

Public profile URL


Public profile settings URL



Smart Field

Liquid variable

Recruiter code


Note: you can also copy/paste this liquid to the end of a hyperlink field

Recruits count

{{ recipient.recruits_count }}

Account-level settings

Smart Field

Liquid variable

Primary site URL


Unsubscribe URL


Organization name

{{ settings.official_name }}

Broadcaster settings

Smart Field

Liquid variable

Broadcaster name

{{ }}

Broadcaster email

{{ }}

Broadcaster phone number

{{ broadcaster.phone_number }}

Custom Fields

While it is not yet possible to add custom fields using the Smart Fields menu, you can still add these variables to your emails using the following Liquid tag convention:

{{ recipient.custom_values_for_display['custom_field_slug' }}

This method is similar to the one described for public profiles here — simply replacing profile with recipient.

Do liquid conditionals still work?

Yes, using liquid in the content editor or in the template — including all available signup variables and conditional IF/ELSE logic tags — will still work as expected. No functionality is changing or being deprecated, we are only adding new functionality.

Create an email blast

Did this answer your question?