~%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

Responses

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.