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.
Examples of use
~%Insert{
"field":"team_property",
"property":"Description"
}
Deprecated macros
- Bcc
- Cc
- Date
- InsertRecipientFirstName
- InsertRecipientFullName
- InsertRecipientLastName
- InsertSenderFirstName
- InsertSenderFullName
- InsertSenderLastName
- Location
- Subject
- Time
- To
- MailboxProperty
- ProfileProperty
- TeamProperty