Сomplete list of macros for templates

In Shared Email Templates for Outlook

The Shared Email Templates app for Outlook offers a variety of macros for your templates. Macros let you avoid repetitive actions, you can once insert a macro instead of attaching the same file over and over again, pasting certain email address into the To, Cc, Bcc fields, adding text to the Subject field, and much more.

On this page, find the complete list of macros, short descriptions of what they do, syntax and examples. For a detailed guide on how to use macros, please refer to the How to use macros page.

Tip. Many of the macros let you not only enter values but also select them from a drop-down list. For this, you need to embed the ~%WHAT_TO_ENTER macro into square brackets.
Macro Description
FillTo Inserts the specified email address(es) into the To field of a message or the Required Attendees field of a meeting. Any previously added addresses are deleted.

Syntax:
~%FILLTO[email address 1; email address 2]

Examples:
~%FILLTO[john@mydomain.com]

~%FILLTO[john@mydomain.com; jim@anotherdomain.com]

~%FILLTO[~%WHAT_TO_ENTER[john@mydomain.com;​{title:"Email address"}]]

~%FILLTO[~%WHAT_TO_ENTER[john@mydomain.com;​​jim@anotherdomain.com;{title:"Email address",​multiselect,editable}]]

~%FILLTO[~%WHAT_TO_ENTER[{dataset:"Contact list",column:"Email",title:"Email address"}]]

More information

FillCc Inserts the specified email address(es) into the Cc field of a message or the Optional Attendees field of a meeting. Any previously added addresses are deleted.

Syntax:
~%FILLCC[email address 1; email address 2]

Examples:
~%FILLCC[john@mydomain.com]

~%FILLCC[john@mydomain.com; jim@anotherdomain.com]

~%FILLCC[~%WHAT_TO_ENTER[john@mydomain.com;​{title:"Email address"}]]

~%FILLCC[~%WHAT_TO_ENTER[john@mydomain.com;​jim@anotherdomain.com;{title:"Email address",multiselect,editable}]]

~%FILLCC[~%WHAT_TO_ENTER[{dataset:"Contact list",​column:"Email",title:"Email address"}]]

More information

FillBcc Inserts the specified email address(es) into the Bcc field. Any previously added addresses are deleted.

Syntax:
~%FILLBCC[email address 1; email address 2]

Examples:
~%FILLBCC[john@mydomain.com]

~%FILLBCC[john@mydomain.com; jim@anotherdomain.com]

~%FILLBCC[~%WHAT_TO_ENTER[john@mydomain.com;​{title:"Email address"}]]

~%FILLBCC[~%WHAT_TO_ENTER[john@mydomain.com;​jim@anotherdomain.com;​{title:"Email address",multiselect,editable}]]

~%FILLBCC[~%WHAT_TO_ENTER[{dataset:"Contact list",​column:"Email",title:"Email address"}]]

More information

FillSubject Inserts the specified text into the Subject field of a message or the Title field of an appointment or meeting. Any previously added text is deleted.

Syntax:
~%FILLSUBJECT[Subject text]

Example:
~%FILLSUBJECT[Price list 2021]

~%FILLSUBJECT[~%WHAT_TO_ENTER[Price list 2021;​{title:"Enter subject"}]]

~%FILLSUBJECT[~%WHAT_TO_ENTER[Price January;Price February;​{title:"Enter subject",multiselect,editable}]]

~%FILLSUBJECT[~%WHAT_TO_ENTER[{dataset:"Price lists",​column:"Price name",title:"Enter subject"}]]

More information

AddTo Adds the specified email address(es) to the To field of a message or the Required Attendees field of a meeting. All the previously added addresses are kept.

Syntax:
~%ADDTO[email address 1; email address 2]

Examples:
~%ADDTO[john@mydomain.com]

~%ADDTO[john@mydomain.com; jim@anotherdomain.com]

~%ADDTO[~%WHAT_TO_ENTER[john@mydomain.com;​{title:"Email address"}]]

~%ADDTO[~%WHAT_TO_ENTER[john@mydomain.com;​jim@anotherdomain.com;​{title:"Email address",multiselect,editable}]]

~%ADDTO[~%WHAT_TO_ENTER[{dataset:"Contact list",​column:"Email",title:"Email address"}]]

More information

AddCc Adds the specified email address(es) to the Cc field of a message or the Optional Attendees field of a meeting. All the previously added addresses are kept.

Syntax:
~%ADDCC[email address 1; email address 2]

Examples:
~%ADDCC[john@mydomain.com]

~%ADDCC[john@mydomain.com; jim@anotherdomain.com]

~%ADDCC[~%WHAT_TO_ENTER[john@mydomain.com;​{title:"Email address"}]]

~%ADDCC[~%WHAT_TO_ENTER[john@mydomain.com;​jim@anotherdomain.com;​{title:"Email address",multiselect,editable}]]

~%ADDCC[~%WHAT_TO_ENTER[{dataset:"Contact list",​column:"Email",title:"Email address"}]]

More information

AddBcc Adds the specified email address(es) to the Bcc field. All the previously added addresses are kept.

Syntax:
~%ADDBCC[email address 1; email address 2]

Examples:
~%ADDBCC[john@mydomain.com]

~%ADDBCC[john@mydomain.com; jim@anotherdomain.com]

~%ADDBCC[~%WHAT_TO_ENTER[john@mydomain.com;​{title:"Email address"}]]

~%ADDBCC[~%WHAT_TO_ENTER[john@mydomain.com;​jim@anotherdomain.com;​{title:"Email address",multiselect,editable}]]

~%ADDBCC[~%WHAT_TO_ENTER[{dataset:"Contact list",​column:"Email",title:"Email address"}]]

More information

AddSubject Adds the specified text to Subject field of a message or the Title field of an appointment or meeting. Previously added text is kept.

Syntax:
~%ADDSUBJECT[Subject text]

Example:
~%ADDSUBJECT[Price list 2021]

~%ADDSUBJECT[~%WHAT_TO_ENTER[Price list 2021;​{title:"Enter subject"}]]

~%ADDSUBJECT[~%WHAT_TO_ENTER[Price January;Price February;​{title:"Enter subject",multiselect,editable}]]

~%ADDSUBJECT[~%WHAT_TO_ENTER[{dataset:"Price lists",​column:"Price name",title:"Enter subject"}]]

More information

AttachFromURL Attaches a file from the URL you specify.

Syntax:
~%ATTACH_FROM_URL[an url of a file to attach]

Example:
~%ATTACH_FROM_URL[https://email-templates.app/assets/attachment.txt]

More information

AttachFromOneDrive Attaches a file from your OneDrive.

Syntax:
~%ATTACH_FROM_ONEDRIVE[a link to a file to attach]

Example:
~%ATTACH_FROM_ONEDRIVE[Price List.xlsx;b!H0xYb9pCJ]

More information

AttachFromSharePoint Attaches a file from your SharePoint.

Syntax:
~%ATTACH_FROM_SHAREPOINT[a link to a file to attach]

Example:
~%ATTACH_FROM_SHAREPOINT[Document.docx;b!1fDQXB7eC0m]

More information

WhatToAttach Reminds you to attach a file from your hard drive or SSD.

Syntax:
~%WHAT_TO_ATTACH

More information

InsertPictureFromOneDrive Inserts a picture from your OneDrive.

Syntax:
~%INSERT_PICTURE_FROM_ONEDRIVE[a link to an image file]

Example:
~%INSERT_PICTURE_FROM_ONEDRIVE[Scheme.png;b!H0xYb9pCJ]

More information

InsertPictureFromURL Inserts a picture from the URL you specify.

Syntax:
~%INSERT_PICTURE_FROM_URL[an url of an image to insert]

Example:
~%INSERT_PICTURE_FROM_URL[https://cdn.ablebits.com/_img-docs/outlook-plugins/shared-templates/desktop-intro-2.png]

More info

InsertPictureFromSharePoint Inserts an image from your SharePoint.

Syntax:
~%INSERT_PICTURE_FROM_SHAREPOINT[a link to an image file]

Example:
~%INSERT_PICTURE_FROM_SHAREPOINT[Scheme.png;b!H0xYb9p]

More information

ClearBody Clears the message body when you insert a template into your message.

Syntax:
~%CLEARBODY

More information

FromAccount Checks if account in the From field is the same as the account in the square brackets. If they differ, the template is not inserted.

Syntax:
~%FROM_ACCOUNT[email address from which the message should be sent]

Examples:
~%FROM_ACCOUNT[jessica@company.com]

~%FROM_ACCOUNT[~%WHAT_TO_ENTER[jessica@company.com;​{title:"Enter account"}]]

~%FROM_ACCOUNT[~%WHAT_TO_ENTER[jessica@company.com;​kim@company.com;{title:"Select account"}]]

More information

Note Adds an inner note to a template.

Syntax:
~%NOTE[Text of a note]

Example:
~%NOTE[Only for corporate customers]

More information

Subject Inserts the content of the Subject field into a message or the content of the Title field into the appointment/meeting body.

Syntax:
~%SUBJECT

More information

Date Inserts the current date into a message or to the appointment/meeting body.

Syntax:
~%DATE

More information

Time Inserts the current time into a message or to the appointment/meeting body.

Syntax:
~%TIME

More information

WhatToEnter Prompts you to enter some text every time you insert a template into a message. Offers four options: text field, dropdown list, date, dataset. Can be used as a value in square brackets in other macros.

Text field
Syntax:
~%WHAT_TO_ENTER[Default value;{title:"Window title"}]

Example:
~%WHAT_TO_ENTER[10%;{title:"Discount"}]

Dropdown list
Syntax:
~%WHAT_TO_ENTER[Item 1;Item 2;Item 3;{title:"Window title"}]

~%WHAT_TO_ENTER[Item 1;Item 2;Item 3;{title:"Window title",editable}]

~%WHAT_TO_ENTER[Item 1;Item 2;Item 3;​{title:"Window title",multiselect,delimiter:"selected delimiter"}]

~%WHAT_TO_ENTER[Item 1;Item 2;Item 3;​{title:"Window title",multiselect,editable,delimiter:"selected delimiter"}]

Example:
~%WHAT_TO_ENTER[10%;20%;30%;{title:"Discount",multiselect,editable,delimiter:", "}]

Date
Syntax:
~%WHAT_TO_ENTER[{date,title:"Window title"}]

Example:
~%WHAT_TO_ENTER[{date,title:"Contract date"}]

Dataset
Syntax:
~%WHAT_TO_ENTER[{dataset:"Dataset name",​column:"Target column",title:"Window title"}]

Example:
~%WHAT_TO_ENTER[{dataset:"Promo",​column:"Discount",title:"Discount"}]

More information

MailboxProperties Inserts the email address, display name, or timezone associated with your Outlook mailbox.

Syntax:
~%MAILBOX_PROPERTIES[Name of a mailbox property]

Examples:
~%MAILBOX_PROPERTIES[EmailAddress]

~%MAILBOX_PROPERTIES[~%WHAT_TO_ENTER[EmailAddress;TimeZone;​{title:"Select mailbox property"}]]

More information

ProfileProperties Inserts the user name, first name, last name, full name, birthday, and email address that are associated with your Shared Email Templates profile. You can create additional properties and get them inserted as well.

Syntax:
~%PROFILE_PROPERTIES[Name of a profile property]

Examples:
~%PROFILE_PROPERTIES[UserName]

~%PROFILE_PROPERTIES[~%WHAT_TO_ENTER[UserName;FirstName;​{title:"Select profile property"}]]

More information

TeamProperties Inserts the display name, description, or Team Password. You can create additional properties and get them inserted as well.

Syntax:
~%TEAM_PROPERTIES[Name of a team property]

Examples:
~%TEAM_PROPERTIES[TeamPassword]

~%TEAM_PROPERTIES[~%WHAT_TO_ENTER[TeamPassword;Description;​{title:"Select team property"}]]

More information

To Inserts the content of the To field into a message or of the Required Attendees field to the appointment/meeting body.

Syntax:
~%TO

More information

Cc Inserts the content of the Cc field into a message or of the Optional Attendees field to the appointment/meeting body.

Syntax:
~%CC

More information

Bcc Inserts the content of the Bcc field into a message.

Syntax:
~%BCC

More information

InsertRecipientFirstName Inserts the first name of the recipient into a message or the meeting body if the name is displayed in the To/Required field. Otherwise, the email address is inserted.

Syntax:
~%INSERT_RECIPIENT_FIRSTNAME

More information

InsertRecipientFullName Inserts the full name of the recipient into a message or the meeting body if the name is displayed in the To/Required field. Otherwise, the email address is inserted.

Syntax:
~%INSERT_RECIPIENT_FULLNAME

More information

InsertRecipientLastName Inserts the last name of the recipient into a message or the meeting body if the name is displayed in the To/Required field. Otherwise, the email address is inserted.

Syntax:
~%INSERT_RECIPIENT_LASTNAME

More information

InsertSenderFirstName Inserts the first name of the sender into a message.

Syntax:
~%INSERT_SENDER_FIRSTNAME

More information

InsertSenderFullName Inserts the full name of the sender into a message.

Syntax:
~%INSERT_SENDER_FULLNAME

More information

InsertSenderLastName Inserts the last name of the sender into a message.

Syntax:
~%INSERT_SENDER_LASTNAME

More information

FillLocation Inserts info into the Location field of an appointment or meeting. If Location already contains some text, that text will be deleted.

Syntax:
~%FILLLOCATION[Location text]

Examples:
~%FILLLOCATION[Room 1]

~%FILLLOCATION[~%WHAT_TO_ENTER[Room 1;​{title:"Enter location"}]]

~%FILLLOCATION[~%WHAT_TO_ENTER[Room 1;​Room 2;{title:"Select location",multiselect,editable}]]

More information

AddLocation Adds info to the Location field of an appointment or meeting keeping the current information.

Syntax:
~%ADDLOCATION[Location text]

Examples:
~%ADDLOCATION[Room 1]

~%ADDLOCATION[~%WHAT_TO_ENTER[Room 1;​{title:"Enter location"}]]

~%ADDLOCATION[~%WHAT_TO_ENTER[Room 1;​Room 2;{title:"Select location",multiselect,editable}]]

More information

Location Inserts the content of the Location field into the appointment or meeting body.

Syntax:
~%LOCATION

More information

Responses

Hello,
First of all, thanks for you tool.

I would like to insert the same text in several templates. This text doesn't often evolve but instead of copying the same text in many templates and have to change it manually everywhere from time to time, i would prefer to insert it as a template in templates where it has to appear, in order to only have to change it in one place when necessary.
Is it yet possible ? Could you implement that soon as a macro ?
Thanks.

Reply

It is not possible with the current version but will be available with the upcoming one. Within a week or two. The complete information about all releases you can find here: https://www.ablebits.com/docs/outlook-shared-templates-release-notes/

Reply

Hi!,

Is there a way I can include a future date in the message body? I send out meeting reminder emails a few days in advance and want to be able to have that day pre-typed for me (e.g. have a date that displays the month and day of the next Wednesday). Is the there a way I can do this?

Thank you!

Reply

Hi Ted,

Thank you for your comment. Unfortunately, the functionality you've described is not available in the current version of the add-in. However, your idea sounds interesting and I have forwarded it to our development team. They will discuss this feature and we’ll be sure to let you know if/when it is available. Thank you!

Reply

Hi

Are you going to add the ~%FROM_ACCOUNT into Shared Email Templates? We use Shared Mailboxes to send the vast majority of our emails so the templates are a great way to ensure that they are being sent from the correct account and users do not need to change anything themselves.

Thanks

Reply

Hi Justin,

Thank you for sharing your idea with us. I will forward it to our development team and let you know via email. Have a nice day!

Reply

Are there any plans to add this macro to Share Email Templates yet? I would really like to move to the new product as it has several advantages over Template Phrases however we use this macro extensively so don't want to switch over until this has been added.
Thanks

Hello Justin,

Thank you for your question. Please note that the ~%FROM_ACCOUNT macro is already available in Shared Email Templates. For more details, please visit this help page.

I am using the What to Enter macro and setting it to enter a date. When I enter the date, the template is populated with the day before.

Reply

Hello Sandra,

Thank you for reporting the problem. Our development team will try to reproduce it and find the cause.

Reply

Is it possible to make a macro to start a new message with a user template? So many steps to dig through for an often used template.

Reply

Hello Jo,

Thank you for your question.

Unfortunately, Microsoft Mail API doesn't provide a possibility to implement this functionality in the add-in.

To quickly get access to your templates, we recommend to pin the add-in pane on one side of your Outlook window, add the templates you use most often to your Favorites and use shortcuts for them. Also, you can select some text in the message body and instantly search for templates that contain this text in names or content.

Please let us know if you have any other questions.

Reply

Ask a question (posted publicly)

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.