Insert pictures into templates

Before you start

Before adding images in Shared Email Templates, read the notes below.

• To avoid signing in to your Microsoft account each time you insert images from OneDrive or SharePoint, turn on the single sign-on feature.
• When inserting a picture from OneDrive with the InsertPicture macro in a template that is shared with other users, make sure that your teammates have access to the corresponding file or folder in OneDrive. For example, you can create a special folder in your OneDrive, share it with all your teammates, and collect all the images you share in templates there. For detailed information on managing access in OneDrive, visit the Share OneDrive files and folders page on the Microsoft Support website.
• When inserting a picture from SharePoint with the InsertPicture macro in a template that is shared with other users, make sure that your teammates have access to the corresponding file or folder in SharePoint. For detailed information on managing access in SharePoint, visit the Share SharePoint files or folders page on the Microsoft Support website.
• When you use a template containing the InsertPicture macro, the add-in transfers the chosen file directly from your OneDrive or SharePoint to your computer.
• When you use a template containing the InsertPicture macro to insert an image from SharePoint, you have to be logged in to SharePoint so that the macro has access to the file.
• Inserting images from SharePoint with the InsertPicture macro won't work on free accounts, such as Outlook.com, as they do not have SharePoint.
• When inserting a picture from a URL with the InsertPicture macro in a template that is shared with other users, make sure that your teammates have access to the specified URL.

• If you see an error message saying that your attached picture can't be added, please check the size of the picture and try to decrease it.

Insert a picture from OneDrive

How to add a picture from OneDrive to an email template

This video will show you how to add a picture from OneDrive to your email template. You'll also learn how to preview pictures directly in your template.

1. On the template editor toolbar, click the Insert picture button.
   
2. Select Insert picture from OneDrive.
   
3. Select a picture you want to insert.
   

   Tip. To upload a picture from your local storage to OneDrive, select the Upload button.
   

4. You can set the size of the picture. Otherwise, its original dimensions will be kept. You can also add the link URL and the link title, or you can leave these fields empty. When you're done, click OK.
   

   Note. The Lock aspect ratio checkbox is selected by default to keep the original proportions of the picture even if it's resized.

5. The InsertPicture macro placeholder will be added to your template. Select the Save button.
   

   Note. To replace InsertPicture macro placeholders in your templates with the corresponding pictures from OneDrive, go to Profile > Edit account and select the Preview pictures for InsertPicture macros checkbox.
   

Insert a picture from SharePoint

How to add a picture from SharePoint to an email template

This tutorial explains how to automatically insert an image from SharePoint into your email using a template and what to do to see the image right in the template.

1. On the template editor toolbar, click the Insert picture button.
   
2. Select Insert picture from SharePoint.
   
3. Select a picture you want to use.
   

   Tip. To upload a file from your local storage to SharePoint, select the Upload button.

   

4. You can set the size of the picture and specify the link URL and the link title. If you do not enter the width and the height of the picture, the original dimensions of the picture will be kept. Click OK.
   

   Note. The Lock aspect ratio checkbox is selected by default to keep the original proportions of the picture even if it's resized.

5. In your template, you'll see the InsertPicture macro placeholder. Select the Save button.
   

   Note. To replace InsertPicture macro placeholders in your templates with the corresponding pictures from SharePoint, go to Profile > Edit account and select the Preview pictures for InsertPicture macros checkbox.
   

Insert a picture from a user profile, a team, or a company account property

How to add a picture from team properties to an email template

Discover how to create a custom team property in the add-in, use it to add a picture to your email, and preview the picture in your template.

1. On the template editor toolbar, click the Insert picture button.
   
2. Select Insert picture from property.
   
3. In the Insert picture dialog, select a property type (company account property, team property, or user property) and the property name. You can also set the size of the picture and add the link URL and the link title. If you do not enter the width and height, the original dimensions will be kept. When you're done, click OK.

   

   Tip. With the Insert nested macro button, you can open a list of macros that can be nested and select the one you need.
   

4. The InsertPicture macro placeholder will be added to your template. Select the Save button.
   

   Note. To replace InsertPicture macro placeholders in your templates with the corresponding pictures from properties, go to Profile > Edit account and select the Preview pictures for InsertPicture macros checkbox.
   

Insert a profile photo from Azure Active Directory

1. On the template editor toolbar, click the Insert picture button.
   
2. Select Insert photo from Azure AD.
   
3. Via the Insert photo dialog, you can set the size of the photo and enter the link URL and the link title. This is optional. If you do not specify the width and the height, the original dimensions will be kept. Click OK.
   

   Tip. With the Insert nested macro button, you can open a list of macros that can be nested and select the one you need.
   

4. The InsertPicture macro placeholder will appear in your template. Select the Save button.
   

Single sign-on (SSO) for OneDrive and SharePoint

If you have only one OneDrive account that is the same as your Microsoft 365 Outlook account, you can take advantage of single sign-on to avoid entering or confirming your credentials each time you insert images from OneDrive or SharePoint.

With single sign-on, you'll need to accept required permissions only once. After that, all images will be inserted without any additional pop-ups.