~%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.
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?
Hello Avery,
Thank you for your question. You can solve your task by using a nested macro. Just insert the Fill Subject or Add to Subject macro with a nested What to Enter macro into your template. Please have a look at the corresponding help page.
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
Hello Ageo,
Thank you for your interest in our software.
Please try to use the WhatToEnter macro instead. For more details, please visit this help page:
Create templates with fillable fields, dropdown lists, etc.
If you have any other questions or need further assistance, please don't hesitate to email us at support@ablebits.com.
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.
