~%Insert

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