Email Placeholder Tags

A placeholder tag is a piece of text formatted in a specific format, which is then processed and replaced by a dynamic value - this means that you can personalize email content to a large degree.

The email placeholder tag format is {{PlaceholderName||”fallback value”}}, and tags can be used in:

  • Email bodies (on pages) - including in links, for example <a href="/UserInfo.aspx?UserName={{Email:User.UserName}}">Click here to see your profile</a>
  • Subject fields (when creating emails)
  • Tracking provider fields

If you do not provide a fallback value, and the user does not have a value to replace the placeholder tag with, it will simply print the placeholder tag. So, to avoid addressing your users as Dear {{Email:User.Name}}, always provide a fallback value.

The following tags are available: 

Placeholder name

Description

EmailMessaging:Recipient.Id

The recipient id. This is not related to the user id.

EmailMessaging:Recipient.Key

The recipient key. When using the "Dynamicweb users" recipient provider, this is the user id.

EmailMessaging:Recipient.Name

The name of the recipient.

EmailMessaging:Recipient.Email

The email address of the recipient.

EmailMessaging:Message.Id

The message id. This identifier is not the email id. If split test is used, there will be one message id for both the original and the variation.

EmailMessaging:Message.SenderName

The sender name.

EmailMessaging:Message.SenderEmail

The sender email address, or the reply-to email address.

EmailMessaging:Message.Subject

The subject. If split test is used, this will contain the subject for the given version (original or variation).

EmailMessaging:Message.DomainUrl

The domain url. This url is the domain used for the links in the content.

EmailMessaging:Message.SendDate

The send date/time. This is the time when the message was sent. If the email is recurring, this value updated each time the email is sent.

EmailMessaging:Recipient.Secret

The recipient secret used for recipient-specific actions like unsubscribing.
This is automatically added to auto-generated unsubscribe links to prevent spoofing.
Note: This will cause unsubscribe links generated
prior to 8.4.1 to become invalid when upgrading to 8.4.1 or later.

EmailMarketing:Email.PreHeader

The pre-header span. This contains the pre-header text wrapped in a span-tag.
Must be placed right after the body tag of the page used as email. If the tag is not found, the preheader will be inserted automatically by the system.

EmailMarketing:Email.PreHeader.Clean

The pre-header text. This contains the pre-header text.

EmailMarketing:Email.ContentLink.Clean

The link to the content page. This contains the link (not in a tag) to the page that provided the content for the email.

EmailMarketing:Email.UnsubscribeLink

The unsubscribe link in a tag. This contains the unsubscribe link wrapped in an a-tag using the "Unsubscribe text" as the link text.

EmailMarketing:Email.UnsubscribeLink.Clean

The unsubscribe link. This contains the unsubscribe link (not in a tag).

EmailMarketing:Email.UnsubscribeAllLink.Clean

The link to completely unsubscribe the recipient using the EmailAllowed property of the User. This tag exists in addition to the regular customizable unsubscribe link to allow for more flexibility. The unsubscribe link is not wrapped in an html anchor (<a>) tag. This value is only available when using the
"Dynamicweb users" recipient provider (available from 8.4.1.0). The placeholder needs to be added manually.

EmailMarketing:Email.TrackingImage

The tracking image for the email. This can be place independently of the pre-header (available from 8.4.1.0).

Email:User.UserName

The username.

Email:User.Name

The name of the user.

Email:User.Address

The address of the user.

Email:User.Address2

The address2 of the user.

Email:User.ZipCode

The zip code of the user.

Email:User.City

The city of the user.

Email:User.Country

The country of the user.

Email:User.Phone

The phone of the user.

Email:User.PhonePrivate

The private phone of the user.

Email:User.PhoneMobile

The mobile phone of the user.

Email:User.Fax

The fax of the user.

Email:User.CustomerNumber

The customer number of the user.

Email:User.Currency

The default currency for the user.

Email:User.Image

The link to the image of the user. This link is not handled by the internal link management.

Email:User.Company

The company of the user.

Email:User.Department

The department of the user.

Email:User.JobTitle

The job title of the user.

Email:User.PhoneBusiness

The business phone of the user.

Email:User.LoginToken

The login token for logging the specified User in automatically. (Available from 8.4.1.0).

Example: {{EmailMessaging:Message.DomainUrl}}/loginpage.aspx?Username={{Email:User.UserName}}&PwToken={{Email:User.LoginToken}}

Email:User.SYSTEMNAME_OF_CUSTOM_FIELD

It is possible to get custom fields on users out in the email (available from 8.6.1.0).
 

Use the system name of the custom field that should be used, not the name. 

Example:  {{Email:User.AccessUser_CustomTextField}} will get the CustomTextField content out in the mail.

A dropdown with placeholder tags can be added to any rich text editor in Dynamicweb by editing the Editor Configuration used - see email.js for an example.