~%Insert

Heads up! We're moving the Shared Email Templates for Outlook documentation to our new site: email-templates.app. The new version will be ready soon, and we hope you'll love the fresh, improved experience. Thank you for your patience during this transition.

Description

When you insert a template into the current email message, appointment, or meeting, this macro inserts the text of the specified entity into the current macro position.

Email

You can use:

  • To, Cc, Bcc, or Subject to insert the text of the corresponding email field.
  • 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

You can use:

  • To for the Required Attendees field, Cc for the Optional Attendees field, Subject for the Title field, or Location to insert the text of the corresponding field.
  • 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" |
        "dataset_value"
     // 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" )
     // in case of dataset_value
     ("dataset":"textvalue",
     "keyvalue":"textvalue",
     "column":"textvalue")
}

Works for

  • Email templates.
  • Appointment and meeting 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
  • DatasetValue

Please contact us here

Our working hours:
Pacific Time (PT) 11:00 PM (previous day) – 2:00 PM
Central European Time (CET) 08:00 - 23:00
Eastern Time (ET) 2:00 AM – 5:00 PM
Central Time (CT) 1:00 AM – 4:00 PM
Pacific Time (PT) 11:00 PM (previous day) – 2:00 PM
Australian Eastern Daylight Time (AEDT) 6:00 PM – 9:00 AM (next day)
If you want to attach files (e.g. screenshots or log files), it will be possible right after you send this form and we automatically create a support ticket for you.