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.