The Shared Email Templates ~%Insert macro

Description

When you paste a template into the current email message, this macro inserts the text of the specified entity into the current macro position.

Email

In case of emails, you can use:

To, Cc, Bcc, or Subject to insert the text of the corresponding email fields.
Today or Now to insert the current date or time.
Recipient or Sender to insert their first, last, or full name.
Mailbox Property, Profile Property, or Team Property to insert the text of the specified property.
AAD Property to insert the text of the specified property.

Calendar

In case of calendar events, you can use:

To, Cc, Subject, or Location to insert the text of the corresponding calendar event fields.
Today or Now to insert the current date or time.
Sender to insert the sender's first, last, or full name.
Mailbox Property, Profile Property, or Team Property to insert the text of the specified property.
AAD Property to insert the text of the specified property.

Syntax

~%Insert{
"field":"to" | "cc" | "bcc" | "subject" | "location" |
"today" | "now" |
"recipient_first_name" | "recipient_full_name" | "recipient_last_name" |
"sender_first_name" | "sender_full_name" | "sender_last_name" |
"mailbox_property" | "profile_property" | "team_property" | "signature" |
"aad_property" | "link_to_onedrive_file" | "link_to_sharepoint_file"
// in case of properties and AAD
"property":"textvalue",
// in case of signature
"property":"signature_name",
// in case of today, now
[ "format":"textvalue", ]
[ "locale":"textvalue" ]
// in case of link to OneDrive or SharePoint
("driveId":"textvalue",
"fileId":"textvalue",
"fileName":"textvalue",
"permissions":"view" | "edit",
"scope":"anonymous" | "organization" )
}

Works for

Email templates.
Calendar event templates.
The macro is not supported for Mail Merge templates except for mailbox, profile, team, and AAD properties.

Built-in property names

Built-in mailbox properties: emailaddress, displayname, timezone.

Built-in profile properties: username, firstname, fullname, lastname, birthday, licensekey, emailaddress.

Built-in team properties: teampassword, displayname, description.

Special profile properties: DateFormat, DateLocale, DefaultOneDriveFolder, DefaultSharePointFolder.

Special team properties: DateFormat, DateLocale, DefaultOneDriveFolder, DefaultSharePointFolder.

AAD properties: those text properties mentioned in "Microsoft Graph REST API v1.0 User Properties" that can be changed by an Azure AD administrator.

Responses

Kent Carle says:

March 27, 2023 at 7:24 pm

I am trying to add an Outlook Distribution list to the To Macro, and I don't understand the following context:
~%Insert{"field":"to"}

All I want inserted are the Outlook Group Names:
SLH-Customer (ISCV Upgrade) and SLH-Philips (ISCV Upgrade).

Does field = SLH-Customer (ISCV Upgrade), or does To = this?

Ekaterina Pechyonkina (Ablebits Team) says:

March 28, 2023 at 10:40 am

Hello Kent,

Sorry, you are using the wrong macro. If you need to add recipients in the field To, please choose Fill To or Add To macros. These macros contain the 'values' parameter that must be filled with the email addresses of your recipient, e.g.:
~%Add{
"field":"to",
"values":[
"group email"]
}

Ageo says:

November 22, 2022 at 4:09 pm

Hello,

I am trying Shared Templates, and it likes me.
Question: for the macros, is there a way to insert the username Name instead of the option to insert the sender?
This is because if using a shared mailbox, it uses the name of the shared mailbox (like customer service, HR, etc.), but I would like to use the user name,

Regards,
Ageo

Katerina Bespalaya (Ablebits Team) says:

November 24, 2022 at 1:44 pm

Hello Ageo,

Thank you for your interest in our software.

Please try to use the WhatToEnter macro instead. For more details, please visit this help page:
Create templates with fillable fields, dropdown lists, etc.

If you have any other questions or need further assistance, please don't hesitate to email us at support@ablebits.com.

~%Insert