Merge Tags

You can use email tags (also known as merge tags) to display dynamic and personalized content in your emails and success messages.

This guide shows you how to personalize your emails and success messages using merge tags.

What is a Merge Tag? #What is a Merge Tag?

A merge tag is a placeholder that allows you to personalize email campaigns and confirmation messages. Merge tags are also known as personalization fields or personalization tags.

Noptin merge tags are usually enclosed between two opening square brackets ([[) and two closing square brackets (]]).

For example,

Each subscriber has a unique email address. When you include the [[email]] merge tag in your email campaigns, each subscriber receives an email with the merge tag replaced by the subscriber’s actual email.

Top ↑

Where Can You Use Merge Tags? #Where Can You Use Merge Tags?

You can use merge tags in the success messages shown to users after they subscribe to your newsletter,

… the confirmation messages shown to subscribers who confirm their email addresses, unsubscribe from your newsletter, or re-subscribe to your newsletter,

… the double opt-in confirmation email,

or normal email campaigns including the new post notifications and welcome emails.

Top ↑

Available Merge Tags #Available Merge Tags

Below is a list of the available merge tags.

Blog Tags #Blog Tags

[[blog_name]]

Displays the blog name.

[[blog_description]]

Displays the blog description.

[[home_url]]

Displays the blog’s URL.

[[noptin_company]]

Displays the company name that you set in Noptin > Settings > Emails.

[[noptin]]

Displays a personalized link to our website.

[[date]]

Displays today’s date, in the format set in your WordPress settings.

[[year]]

Displays the current year.

Top ↑

Subscriber Tags #Subscriber Tags

[[unsubscribe_url]]

Inserts a URL to unsubscribe from the newlsetter.

[[resubscribe_url]]

Inserts a URL to re-subscribe to the newsletter. Useful in cases where a subscriber unsubscribes from your newsletter and decides to resubscribe again.

[[first_name]]

Displays the subscriber’s first name.

[[last_name]]

Displays the subscriber’s last name.

[[email]]

Displays the subscriber’s email address.

[[avatar_url]]

Displays the subscriber’s avatar URL.

[[date_created]]

Displays the date which a subscriber subscribed to your blog.

[[confirm_key]]

Displays the subscriber’s secret confirmation key.

[[$subscriber_field]]

Replace $subscriber_field with any custom field that you’ve added to your website to display the value of that field. For example, phone in the image below.

Top ↑

Post Notifications Tags #Post Notifications Tags

These merge tags are only available when setting up a new posts notification campaign.

[[post_excerpt]]

Displays the post’s summary.

[[post_content]]

Displays the post’s entire content.

[[post_title]]

Displays the post’s title.

[[featured_image]]

Displays the featured image. Please note that this displays the entire featured image, and not just the URL.

[[post_author]]

Displays the author’s name.

[[post_author_email]]

Displays the author’s email address.

[[post_author_login]]

Displays the author’s login name.

[[post_author_id]]

Displays the author’s id.

[[post_date]]

Displays the date a post was published.

[[post_url]]

Displays the post’s URL.

[[post_id]]

Displays the post’s ID.

[[read_more_button]]Read More[[/read_more_button]]

Displays a button linking to the post.

[[post_meta.$key]]

Replace $key with the actual meta key. Displays a post’s custom meta data.

Top ↑

Customer Tags #Customer Tags

These merge tags are available when sending a bulk email or notification to your WooCommerce customers.

[[customer_created]]

This displays the date a customer was created (joined your store).

[[customer_modified]]

Displays the date a customer was last modified (updated their account details).

[[display_name]]

Shows the customer display name as set in his/her profile.

[[billing_first_name]] or [[shipping_first_name]]

Either displays the customer’s first billing or shipping name.

[[billing_last_name]] or [[shipping_last_name]]

Either displays the customer’s last billing or shipping name.

[[billing_address_1]], [[billing_address_2]], [[shipping_address_1]] or [[shipping_address_2]]

Use this to display the customer’s billing or shipping address.

[[billing_city]] or [[shipping_city]]

Displays the customer’s billing or shipping city.

[[billing_postcode]] or [[shipping_postcode]]

This displays the customer’s billing or shipping postcode.

[[billing_country]] or [[shipping_country]]

This merge tag displays the customer’s billing or shipping country.

[[billing_state]] or [[shipping_state]]

Displays the customer’s billing or shipping state / region / province.

[[billing_phone]]

This merge tag displays the customer’s phone number.

[[total_spent]]

Displays the total amount the customer has spent on your store.

[[order_count]]

Displays the total number of orders that the customer has made on your store.

Top ↑

User Tags #User Tags

These merge tags are available when sending an email to your WordPress users.

[[display_name]]

Shows the user’s display name as set in their profile information.

[[user_registered]]

This displays the date a user joined your site.

[[nickname]]

Displays the user’s nickname.

[[description]]

This merge tag displays the user’s description.

[[$user_meta_key]]

Replace “$user_meta_key” with an actual meta key as saved in the wp_usermeta table to display the meta value associated with the user.

Top ↑

Misc Tags #Misc Tags

[[web_url]]

Requires the Campaign Archives addon. Inserts a URL to view the campaign online.

[[noptin_coupon_code]]

Requires the Coupon Codes addon. Displays an automatically-generated unique coupon code.

[[noptin_coupon_code_$automation_id]]

Replace $automation_id with the real automation id. Requires the Coupon Codes addon. Displays an automatically-generated unique coupon code.

Top ↑

Sections #Sections

Sections hide or show content one or more times depending on their values.

A section begins with a pound and ends with a slash. That is, [[#subscriber_tag]] begins a “subscriber_tag” section while [[/subscriber_tag]] ends it.

The behavior of the section is determined by the value of the associated merge tag.

If the associated value is empty / false / 0, the content inside the merge tag won’t display. The reverse is also true.