Merge Tags

Answers by setup and product area.

Merge Tags

Answers by setup and product area.

Custom Field - {{ .Subscriber.Attribs }} The custom field merge tag allows you to insert unique subscriber-specific data, such as gender, location, age, payment amount or other custom fields, into your email and SMS campaigns. These additional fields must exist as column headers in your uploaded contact list CSV file for the system to dynamically populate personalized content. What It Does: This merge tag dynamically pulls values from the additional fields in your contact list (e.g., Gender, Location, Age) and replaces the placeholder with subscriber-specific data. These fields are fully customizable but must be included as column headers in the uploaded CSV file. For example: If your contact list includes a "Gender" column, the system will use the value under that column for each subscriber. You can use multiple custom fields to create highly tailored messages. Important Note: These fields are not predefined attributes but must be uploaded as columns in the CSV contact list. Ensure correct mapping of column headers and subscriber details during the upload process. Example Usage: Dear {{ .Subscriber.FirstName }}, your subscription renewal of {{ .Subscriber.Attribs.amount }} naira is due on {{ .Subscriber.Attribs.date }}. Renew now to continue enjoying our services. Result: Dear John, your subscription renewal of 50,000 naira is due on 15th March 2025. Renew now to continue enjoying our services. Example Code : In this example, the API fetches and inserts the subscriber’s name, location, and discount amount from the contact list to personalize communication.

First Name Merge Tag – {{ .Subscriber.FirstName }} This merge tag pulls the first name of the recipient as stored in your contact list. It’s perfect for creating a friendly and approachable tone in your communication. Use Cases: Sending casual emails or SMS where addressing by the first name feels natural. Automating greetings in promotions, reminders, or thank-you messages. Enhancing customer engagement through familiarity. Example Usage: Hi {{ .Subscriber.FirstName }}, we’re excited to share a special offer just for you! Result: Hi Adrian, we’re excited to share a special offer just for you! API Integration: When using the API, you can dynamically pull the subscriber’s first name into your campaigns. Example Code:

  Full Name Merge Tag - {{ .Subscriber.Name }} This merge tag pulls the full name of the recipient as stored in your contact list. It ensures that your messages are personalized without requiring manual input for each subscriber. When used, it dynamically replaces the tag with the subscriber’s saved full name. Use Cases: Sending formal emails or SMS where addressing someone by their full name is appropriate. Automating personalized greetings in newsletters, confirmations, and updates. Strengthening customer relationships by making messages feel personal. Example Usage: Hello {{ .Subscriber.Name }}, your appointment is confirmed for tomorrow at 10 AM. Please arrive 10 minutes early. Result : Hello John Famous, your appointment is confirmed for tomorrow at 10 AM. Please arrive 10 minutes early. API Integration: When using the API, you can dynamically pull the subscriber’s full name into your campaigns. Here's how it works: Example Code: In this example, the API fetches and inserts the full name stored in the list under the name field for personalized communication.

Last Name Merge Tag – {{ .Subscriber.LastName }} This merge tag pulls the last name of the recipient. It’s suitable for formal or business-like communications. Use Cases: Addressing recipients formally in professional emails or SMS. Customizing notifications or official communications. Building trust through a professional tone. Example Usage: Dear Mr. {{ .Subscriber.LastName }}, we’re writing to inform you about your account status. Result: Dear Mr. Smith, we’re writing to inform you about your account status. API Integration: The API fetches the subscriber’s last name for precise and professional personalization. Example Code:   In this example, the API fetches and inserts the last name stored in the list under the name field for personalized communication.

There are several merge tag template functions and expressions that can be used in campaign and template bodies. They are written in the form {{ .Subscriber.Email }}, that is, an expression between double curly braces {{ and }}. Subscriber fields Expression Description {{ .Subscriber.UUID }} The randomly generated unique ID of the subscriber {{ .Subscriber.Email }} E-mail ID of the subscriber {{ .Subscriber.Name }} Name of the subscriber {{ .Subscriber.FirstName }} First name of the subscriber (automatically extracted from the name) {{ .Subscriber.LastName }} Last name of the subscriber (automatically extracted from the name) {{ .Subscriber.Status }} Status of the subscriber (enabled, disabled, blocklisted) {{ .Subscriber.Attribs }} Map of arbitrary attributes. Fields can be accessed with ., eg: .Subscriber.Attribs.city {{ .Subscriber.CreatedAt }} Timestamp when the subscriber was first added {{ .Subscriber.UpdatedAt }} Timestamp when the subscriber was modified Expression Description {{ .Campaign.UUID }} The randomly generated unique ID of the campaign {{ .Campaign.Name }} Internal name of the campaign {{ .Campaign.Subject }} E-mail subject of the campaign {{ .Campaign.FromEmail }} The e-mail address from which the campaign is being sent Functions Function Description {{ UnsubscribeURL }} Unsubscription and Manage preferences URL. Ideal for use in the template footer. {{ MessageURL }} URL to view the hosted version of an e-mail message.

Connect every marketing channel to one customer journey.

Capture and segment audiences, then coordinate email, SMS, WhatsApp, voice, push, in-app messages, conversations, automations, referrals, loyalty, rewards, ads, and developer APIs from one growth platform.

Get Started