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. |
EmailMarketing:Email.PreHeader |
The pre-header span. This contains the pre-header text wrapped in a span-tag. |
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 |
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). |
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.