~%Insert

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

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?

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

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.