~%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

Responses

Avery Lentine says:
November 12, 2023 at 7:26 pm

Hi! I just discovered this Outlook add-in and I am loving it so far.

Is it possible use this macro to insert the current date into the subject line?

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?

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

Post a comment

Seen by everyone, do not publish license keys and sensitive personal info!

If you have any questions or issues with this add-in, please feel free to post your concerns in the comments area. As soon as we answer, a notification message will be sent to your e-mail. If you do not want to share your thoughts in public, please contact us at support@ablebits.com.