How can we help? 👋

Merge Fields

A deeper dive into understanding Merge Fields and how to use them.

Merge fields automatically insert personalized details into your communication templates, making each message feel tailored without manual effort. They act as placeholders that pull in data like a contact’s name or property address.

In this article, you will learn:

  1. How to Understand Merge fields
  1. How to Use a Merge Field

Understanding Merge Fields

Merge fields let you automatically insert specific data into a communication template, making emails feel more personal—without extra work. Instead of manually customizing each message, merge fields pull in details from a related card like a contact’s name, property address, or other relevant information.

How Merge Fields Work

Think of merge fields as placeholders that get replaced with actual data when an email is sent. For example:

  • Template: "Hello {{firstname}}, welcome to our community!"
  • What the recipient sees: "Hello Sarah, welcome to our community!"

This makes your emails look like they were written just for each recipient!

Using Fallbacks for Missing Data

Sometimes, a contact might not have certain information (like a first name). To avoid awkward blank spaces, you can add a fallback value that appears when data is missing.

🔹 Example:

"Hello {{firstname||fallback:there}}!"

  • If the recipient's name is available → "Hello Sarah!"
  • If the name is missing → "Hello there!"

Adding fallbacks ensures your messages always sound natural, no matter what data is available.

Would you like help setting up your merge fields? Let us know! 😊

Notion image

How to Use a Merge Field

Merge Fields are available to use on Communication Templates, E-Signature Documents, and Forms. Using the merge field picker, you can create templates for any boards, locations, leases, or vendors.

💡
If you change the name of a board, it will affect all merge fields for the communication templates on that board. You will need to update all merge fields for any communication templates pointed to the newly named board.
Notion image

From your Communication Template Editor, select any merge field that you want to add to a template. Then, add a fallback (backup text).

Notion image
💡
Fallbacks cannot be used when inserting a URL merge field. Remove ||fallback: on any URL merge fields.

Frequently Asked Questions

Why aren’t my merge fields showing information?

There are a few reasons that your merge fields aren’t working.

  1. The board name was changed.
      • If the board name is altered in any way, it will break the connection to any existing merge fields. Changes are not responsive. You’ll need to update all merge fields.
  1. There is no related card or contact.
      • For merge fields to populate, the template needs to know where to pull the information from. The best way to ensure this is to send an email from a card. This can be done via automation or manually.
        • Notion image
  1. The field no longer exists or the field name was changed.
      • As with changing board names, field name updates are not responsive with merge fields or form fields. You’ll need to delete and re-add the merge field to the template.

Related Articles

 
Did this answer your question?
😞
😐
🤩