Skip to content

A merge tag is a detail that JungleMail 365 fills in for each recipient when it sends the newsletter, such as {First name}. Which merge tags you can use depends on where the newsletter’s recipients come from, so choose the recipients first. Insert merge tags with Insert merge tag in the email builder, or with Placeholders & Formulas in the subject and preview text (Personalize with merge tags).

If a recipient has no value for a merge tag, it stays empty in their email; {IfEmpty(First name; "colleague")} puts in a word of your own instead (Formulas and functions). A merge tag that does not exist for the recipient source stays in the email as you typed it, so check the newsletter in the Preview step.

Merge tag Gives
{First name} The recipient’s first name. Where the source has none, the first word of the recipient’s name
{JungleMail Recipient Name} The recipient’s name
{JungleMail Recipient Address} The recipient’s email address
{Newsletter Author} The name of the person who sent the newsletter
{Subscription Preferences} With SharePoint subscribers turned on: the topics the recipient chose
{Preferred Language} With SharePoint subscribers turned on: the language the recipient chose

With Email addresses, these are the only merge tags, and the name is the one you typed before the address: "Daniel Okafor" <daniel.okafor@enovapoint.com>.

The details of each user in Microsoft Entra ID:

Merge tag Gives
{First name}, {Last name}, {Display name} The user’s names
{Email address} The user’s email address
{Job title}, {Department}, {Company}, {Office} Where the user works
{Office phone}, {Mobile phone}, {Fax number} The user’s phone numbers
{Street address}, {City}, {State or province}, {ZIP or postal code}, {Country or region} The user’s address
{User alias} The user’s mail alias
{User ID} The user’s sign-in name
{Custom attribute 1} to {Custom attribute 15} The user’s custom attributes 1 to 15

The details of each recipient in Exchange: the same names, email address, job, phone and address merge tags as for Microsoft 365, AD groups, and these:

Merge tag Gives
{Initials}, {Middle name}, {Nick name} More of the recipient’s names
{Profession}, {Manager} The recipient’s profession and manager
{Assistant name}, {Assistant phone} The recipient’s assistant
{Spouse name} The recipient’s spouse or partner
{Home phone} The recipient’s home phone

Every visible column of the list, by its name in square brackets: {[Department]}, {[Start Date]}. They are offered once the list gives at least one recipient. When the list’s recipients are in a person column, these give that person’s details:

Merge tag Gives
{Recipient:[Name]}, {Recipient:[First Name]}, {Recipient:[Last Name]} The person’s names
{Recipient:[Title]}, {Recipient:[Department]}, {Recipient:[Office]} The person’s job title, department and office
{Recipient:[Work Phone]}, {Recipient:[Mobile Phone]} The person’s phone numbers
{Recipient:[Picture]} The person’s picture
{Recipient:[Id]} The person’s user ID
Source Merge tags
File Every column, by its heading: {Department}. Columns are also named by their letter: {Column C}
Dynamics 365 The fields of the Dynamics 365 records you send to
Subscribers Each subscriber field, by the merge tag set for the field (Build subscription forms and fields)
Previous newsletter The same as for the earlier newsletter’s source (Follow up on a previous newsletter)

When JungleMail subscribers are turned on, a merge tag that another source leaves empty is filled from the recipient’s subscriber details, where a subscriber field has the same merge tag.

Merge tag In the list as Gives
{[UnsubscribeURL]} Unsubscribe The recipient’s unsubscribe page (Add an unsubscribe link)
{[UpdateSubscriptionURL]} Manage subscription The page where the recipient changes their subscription, when subscribers are turned on

In a section or block that shows SharePoint content, Insert merge tag has a Dynamic section or Dynamic block tab with the columns of its list. S: is the section’s item and B: the block’s; a merge tag without either is the recipient’s. See Add SharePoint content.

Merge tag In the list as Gives
{S:[Title]}, {B:[Title]} The column’s name That column of the item
{S:[Photo]:[URL]}, {S:[Photo]:[Title]} Column:URL, Column:Title For a picture or hyperlink column, its address and its text
{S:[Created By]:[Picture]}, {S:[Created By]:[PictureCircle]} Column:Picture, Column:PictureCircle For a person column, the person’s picture, square or round
<a href="{S:[ItemUrl]}">{S:[ItemDisplayName]}</a> Link to item A link to the item, with its name
{S:[ItemUrl]} Item URL The item’s address
{S:[ItemDisplayName]} Item display name The item’s name
{S:[FileUrl]} File URL In a document library, the file’s address
{S:[FileThumbnailUrl]} File Thumbnail URL In a document library, a preview image of the file
{CanvasToHtml(S:[CanvasContent1])} Modern Page Content In a Site Pages library, the page’s content
{S:ReadingTime()} Reading time In a Site Pages library, how long the page takes to read
{[Group Title]} Group title In a section grouped by a column, the group’s value
  • For a greeting, {First name}. It works with every recipient source, and where a source has no first name it takes the first word of the name. Give it a fallback, {IfEmpty(First name; "colleague")}, for typed addresses without a name.
  • In a template used with several sources, the merge tags under Every recipient source. {JungleMail Recipient Address} works whatever the recipients, while {Email address} comes from Microsoft 365 and Exchange groups, and stays in the email as typed for a source that doesn’t have it.
  • With typed addresses, type the name too. "Daniel Okafor" <daniel.okafor@enovapoint.com> gives {First name} something to fill in; a bare address leaves it empty.
  • In SharePoint content, Link to item rather than Item URL. It gives the link and the item’s name in one, so the reader sees a title to select, not a long address.