This is an old revision of the document!
Placeholders are available for commonly used personalization like salutations. They can be easily selected by means of a button.
Personalizations that will only be used once can also be integrated via XML. We recommend this option in cases where defining a new placeholder would not be worthwhile, or if you want to replace entire sections of your source code.
Pre-defined placeholders are available to integrate personalized content - such as a salutation or a current date - into an e-mail message.
Placeholders always begin with a dollar sign $. A placeholder must be followed by a space or punctuation mark (e.g. comma, full stop, question mark, exclamation point) to be parsed correctly.
There are 4 types of placeholders.
These placeholders are generally defined by complex functions with a fallback. For example, this is the case with all salutation placeholders, ensuring that recipients whose name is not known are also addressed properly.
Some examples of globally available functions placeholders:
$current_weekday_en | Current weekday, e.g. “Tuesday” |
$salutation_en_formal | Male: Dear Mr NAME, Female: Dear Ms NAME, Fallback: Dear Sir or Madam, |
$salitation_en_firstname | Dear VORNAME, Fallback: Dear Reader, |
$salutation_en_firstname_name | Dear VORNAME NAME, Fallback: Dear Reader, |
Haven’t found any that fulfill your requirements? If you need placeholders with specific functions, please contact our support team. We will set them up according to your needs.
These placeholders are the names of the master data fields available in your client. For example, you can use your recipients’ mailing data as a means of personalization: $mail, $name, $plz, $ort
These placeholders are frequently used, predefined blocks of text. With these, you can insert a reference to the online version ($htmlVersion) or a link to Facebook ($socialLinkFacebook) in the header of your e-mail, or elsewhere.
You can select all placeholders via a drop-down menu. Depending on the editor / e-mail template you’re using, you can find the placeholders here in your e-mail’s editing view:
In the new 2014 editor, you can find them when editing single lines of text: | ![]() |
In the new 2014 editor, you can find them when editing sections of text: | ![]() |
In the editor of the Multipart2015 template: | ![]() |
In the default editor (HTML/text multipart or individually defined template): | ![]() |
In the application promio.mail.one: | ![]() |
Other variable content that can be used in e-mails:
$from_address | Sender’s address |
$redirect_domain | Redirect your sender’s domain |
$newsletterName | Name of the newsletter the e-mail is associated with |
$newsletterId | ID of the newsletter the email is associated with |
$campaignId | ID of the campaign the e-mail is set up in |
$letter_id | E-mail’s ID |
Using XML syntax, you can integrate personalized elements directly into an e-mail’s source code. In addition to personalized salutations, this allows you to replace entire sections of the source code, meaning you can - for example - display different articles depending on the recipients’ age.
{!--<dynamicContent> : Beginning of personalized content </dynamicContent>//--} : End of personalized content <if>...</if> : if loop <elseif>...</elseif> : else/if loop <else>...</else> : fallback <condition>...</condition> : definition of condition <data>...</data> : output
All master data fields defined in your client can be used as a <condition> - for example, mail, vorname (first name), name, gender, birthday. All of the usual comparison operators are allowed.
You can not nest multiple loops using this code. Instead, a placeholder should be defined for more complex tasks.
{!--<dynamicContent><if><condition>name!="" AND gender=2</condition><data>Dear Ms $name!</data></if><elseif><condition>name!="" AND gender=1</condition><data>Dear Mr $name!</data></elseif><else><data>Dear ABC Newsletter readers!</data></else></dynamicContent>//--}
{!--<dynamicContent><if><condition>gender=2 AND name!=""</condition><data>Dear Ms $name - have you bought any jewelery today?</data></if><elseif><condition>gender=1 AND name!=""</condition><data>Dear Mr $name - have you bought any watches today?</data></elseif><else><data>Dear readers - have you seen our top offer of the day?</data></else></dynamicContent>//--}
Do not use line breaks in XML, especially not in subject lines! Line breaks are displayed as spaces.
Placeholders and XML syntax can be used in the following sections of an e-mail:
Depending on the placeholder’s type, you can also use personalization in subject lines, sender names and inside links:
Subject line | Functions, fields, variables, XML |
Links | Fields, $newsletterId, $salutation_de_gender, $date_de, $date_en |
Sender name | Fields, variables |
Placeholders in links are replaced by the actual content at the moment of clicking. This allows security-relevant data to be “hidden”, e.g. to pre-fill forms on landing pages or connect with a website tracking software.
We recommend testing your e-mail’s personalization by sending test e-mails! For technical reasons, some variables are not visible in the promio.mail preview.