~%InsertPicture

Description

When you insert a template into the current email message, appointment, or meeting, this macro inserts the specified picture into the current macro position.

Notes

You can insert a profile picture from Azure AD (a user's photo from their Microsoft account), pictures from public URLs, and pictures from a OneDrive or SharePoint documents folder (library) that is either yours or shared with you. Also, you can specify the size of the picture (its height and width in pixels), add a hyperlink and its display text (title), and opt to use the picture as a hidden email attachment (only for a profile picture from Azure AD and for pictures available from public URLs).

In the case of OneDrive and SharePoint, you can interactively select a picture when inserting or editing the macro—the "driveId", "fileId", "fileName", and "filePath" parameters will be specified automatically.

Syntax

~%InsertPicture{
     "from":"onedrive" | "sharepoint" | "url" | "aad_photo",
     [ "height":"123" | 123,]
     [ "width":"123" | 123,]
     [ "link":"textvalue", ]
     [ "linkTitle":"textvalue", ]
     // in case of OneDrive or SharePoint
     ("driveId":"textvalue",
     "fileId":"textvalue",
     "fileName":"textvalue", )
     ("filePath":"textvalue",)
     // in case of URL
     "url":"textvalue",
     [ "inline":"true" | true | "false" | false ]
}

Works for

  • Email templates.
  • Appointment and meeting templates.
  • Mail Merge templates.

Examples of use

~%InsertPicture{
     "from":"onedrive",
     "width":150,
     "height":150,
     "link":"https://www.ablebits.com/",
     "linkTitle":"Ablebits",
     "fileName":"logo.png",
     "driveId":"b!xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
     "fileId":"01xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
     "filePath":"/b!xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/root:/Shared/Sales/logo.png"
}

Deprecated macros

  • InsertPictureFromOneDrive
  • InsertPictureFromSharePoint
  • InsertPictureFromURL

Please contact us here

Our working hours:
Pacific Time (PT) 11:00 PM (previous day) – 2:00 PM
Central European Time (CET) 08:00 - 23:00
Eastern Time (ET) 2:00 AM – 5:00 PM
Central Time (CT) 1:00 AM – 4:00 PM
Pacific Time (PT) 11:00 PM (previous day) – 2:00 PM
Australian Eastern Daylight Time (AEDT) 6:00 PM – 9:00 AM (next day)
If you want to attach files (e.g. screenshots or log files), it will be possible right after you send this form and we automatically create a support ticket for you.