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. 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.

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

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 selecting the field you want from the dropdown menu, no typing or formatting is necessary!

Do liquid conditionals still work?

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.  Also note, the Liquid in this list can be used in links. 

Smart field: Liquid

Recipient

  • 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: {{ recipient.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 }}
  • Custom fields: {{recipient.custom_values_for_display['custom_field_slug' }}

Primary Address

  • Full address: {{ recipient.address.one_line }}
  • Address 1: {{ recipient.address.address1 }}
  • Address 2: {{ recipient.address.address2 }}
  • Address city: {{ recipient.address.city }}
  • Address state: {{ recipient.address.state }}
  • Address zip: {{ recipient.address.zip }}

Donations

  • 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 }}

Membership

  • 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: {{ recipient.parent.phone }}
  • Point person email: {{ recipient.parent.email }}

Profile

  • Public profile URL: {{recipient.full_profile_url}}
  • Public profile settings URL: {{recipient.settings_url}}

Recruiter

  • Recruiter code: ?recruiter_id={{ recipient.id }}
  • Recruits count: {{ recipient.recruits_count }}

Settings

  • Primary site URL: {{ settings.site.full_url }}
  • Unsubscribe URL: {{ settings.site.unsubscribe_url }}
  • Organization name: {{ settings.official_name }}

Broadcaster

  • Broadcaster name: {{ broadcaster.name }}
  • Broadcaster email: {{ broadcaster.email }}
  • Broadcaster phone number: {{ broadcaster.phone_number }}

Related HOWTOs

Create an email blast

Did this answer your question?