Ms Outlook Addons For Mac



  • Approximately 3 months ago, the button to manage add-ins disappeared from the ribbon in my Outlook for Mac. My add-ins disappeared too. I can still use and manage add-ins. First screenshot shows the ribbons without 'add-ins' button and without any add-ins in Outlook for Mac.
  • Currently there is no support for plug-ins in Outlook for Mac', and AFAIK there has been no indication that Microsoft will add this support option. There are ways to add functionality to Outlook via AppleScript. Currently scripts are very limited in Outlook where Entourage had an extensive library of free scripts.
Ms Outlook Addons For Mac

Outlook add-ins are integrations built by third parties into Outlook by using our web-based platform. Outlook add-ins have three key aspects: The same add-in and business logic works across desktop (Outlook on Windows and Mac), web (Microsoft 365 and Outlook.com), and mobile.

-->

You can create and run an Outlook add-in the same way in Outlook on Mac as in the other clients, including Outlook on the web, Windows, iOS, and Android, without customizing the JavaScript for each client. The same calls from the add-in to the Office JavaScript API generally work the same way, except for the areas described in the following table.

For more information, see Deploy and install Outlook add-ins for testing.

For information about new UI support on Mac, see New Outlook on Mac.

AreaOutlook on the web, Windows, and mobile devicesOutlook on Mac
Supported versions of office.js and Office Add-ins manifest schemaAll APIs in Office.js and schema v1.1.All APIs in Office.js and schema v1.1.
NOTE: In Outlook on Mac, only build 16.35.308 or later supports saving a meeting. Otherwise, the saveAsync method fails when called from a meeting in compose mode. See Cannot save a meeting as a draft in Outlook for Mac by using Office JS API for a workaround.
Instances of a recurring appointment series
  • Can get the item ID and other properties of a master appointment or appointment instance of a recurring series.
  • Can use mailbox.displayAppointmentForm to display an instance or the master of a recurring series.
  • Can get the item ID and other properties of the master appointment, but not those of an instance of a recurring series.
  • Can display the master appointment of a recurring series. Without the item ID, cannot display an instance of a recurring series.
Recipient type of an appointment attendeeCan use EmailAddressDetails.recipientType to identify the recipient type of an attendee.EmailAddressDetails.recipientType returns undefined for appointment attendees.
Version string of the client applicationThe format of the version string returned by diagnostics.hostVersion depends on the actual type of client. For example:
  • Outlook on Windows: 15.0.4454.1002
  • Outlook on the web: 15.0.918.2
An example of the version string returned by Diagnostics.hostVersion on Outlook on Mac: 15.0 (140325)
Custom properties of an itemIf the network goes down, an add-in can still access cached custom properties.Because Outlook on Mac does not cache custom properties, if the network goes down, add-ins would not be able to access them.
Attachment detailsThe content type and attachment names in an AttachmentDetails object depend on the type of client:
  • A JSON example of AttachmentDetails.contentType: 'contentType': 'image/x-png'.
  • AttachmentDetails.name does not contain any filename extension. As an example, if the attachment is a message that has the subject 'RE: Summer activity', the JSON object that represents the attachment name would be 'name': 'RE: Summer activity'.
  • A JSON example of AttachmentDetails.contentType: 'contentType' 'image/png'
  • AttachmentDetails.name always includes a filename extension. Attachments that are mail items have a .eml extension, and appointments have a .ics extension. As an example, if an attachment is an email with the subject 'RE: Summer activity', the JSON object that represents the attachment name would be 'name': 'RE: Summer activity.eml'.

    NOTE: If a file is programmatically attached (e.g through an add-in) without an extension then the AttachmentDetails.name will not contain the extension as part of filename.

String representing the time zone in the dateTimeCreated and dateTimeModified propertiesAs an example: Thu Mar 13 2014 14:09:11 GMT+0800 (China Standard Time)As an example: Thu Mar 13 2014 14:09:11 GMT+0800 (CST)
Time accuracy of dateTimeCreated and dateTimeModifiedIf an add-in uses the following code, the accuracy is up to a millisecond:
JSON.stringify(Office.context.mailbox.item, null, 4);
The accuracy is up to only a second.

New Outlook on Mac (preview)

Outlook add-ins are now supported in the new Mac UI, up to requirement set 1.7. However, the following requirement sets and features are NOT supported yet.

  1. API requirement sets 1.8 and 1.9
  2. Contextual add-ins
  3. On-send
  4. Compose window pop-out
  5. Shared folder support
  6. saveAsync when composing a meeting

We encourage you to preview the new Outlook on Mac, available from version 16.38.506. To learn more about how to try it out, see Outlook for Mac - Release notes for Insider Fast builds.

You can determine which UI version you're on, as follows.

Current UI

New UI (preview)

-->

Outlook add-ins are integrations built by third parties into Outlook by using our web-based platform. Outlook add-ins have three key aspects:

  • The same add-in and business logic works across desktop (Outlook on Windows and Mac), web (Microsoft 365 and Outlook.com), and mobile.
  • Outlook add-ins consist of a manifest, which describes how the add-in integrates into Outlook (for example, a button or a task pane), and JavaScript/HTML code, which makes up the UI and business logic of the add-in.
  • Outlook add-ins can be acquired from AppSource or sideloaded by end-users or administrators.

Outlook add-ins are different from COM or VSTO add-ins, which are older integrations specific to Outlook running on Windows. Unlike COM add-ins, Outlook add-ins don't have any code physically installed on the user's device or Outlook client. For an Outlook add-in, Outlook reads the manifest and hooks up the specified controls in the UI, and then loads the JavaScript and HTML. The web components all run in the context of a browser in a sandbox.

The Outlook items that support add-ins include email messages, meeting requests, responses and cancellations, and appointments. Each Outlook add-in defines the context in which it is available, including the types of items and if the user is reading or composing an item.

Note

If you plan to publish your add-in to AppSource and make it available within the Office experience, make sure that you conform to the Commercial marketplace certification policies. For example, to pass validation, your add-in must work across all platforms that support the methods that you define (for more information, see section 1120.3 and the Office Add-in application and availability page).

Extension points

Extension points are the ways that add-ins integrate with Outlook. The following are the ways this can be done:

  • Add-ins can declare buttons that appear in command surfaces across messages and appointments. For more information, see Add-in commands for Outlook.

    An add-in with command buttons on the ribbon

  • Add-ins can link off regular expression matches or detected entities in messages and appointments. For more information, see Contextual Outlook add-ins.

    A contextual add-in for a highlighted entity (an address)

Ms Teams Outlook Add In For Mac

Mailbox items available to add-ins

Outlook add-ins activate when the user is composing or reading a message or appointment, but not other item types. However, add-ins are not activated if the current message item, in a compose or read form, is one of the following:

Ms Outlook Addons For Mac Os

  • Protected by Information Rights Management (IRM) or encrypted in other ways for protection. A digitally signed message is an example since digital signing relies on one of these mechanisms.

    Important

    • Add-ins activate on digitally signed messages in Outlook associated with a Microsoft 365 subscription. On Windows, this support was introduced with build 8711.1000.

    • Starting with Outlook build 13229.10000 on Windows, add-ins can now activate on items protected by IRM. For more information about this feature in preview, see Add-in activation on items protected by Information Rights Management (IRM).

  • A delivery report or notification that has the message class IPM.Report.*, including delivery and Non-Delivery Report (NDR) reports, and read, non-read, and delay notifications.

  • A draft (does not have a sender assigned to it), or in the Outlook Drafts folder.

  • A .msg or .eml file which is an attachment to another message.

  • A .msg or .eml file opened from the file system.

  • In a shared mailbox, in another user's mailbox, in an archive mailbox, or in a public folder.

  • Using a custom form.

In general, Outlook can activate add-ins in read form for items in the Sent Items folder, with the exception of add-ins that activate based on string matches of well-known entities. For more information about the reasons behind this, see 'Support for well-known entities' in Match strings in an Outlook item as well-known entities.

Ms Outlook Addons For Mac Windows 7

Supported clients

Outlook add-ins are supported in Outlook 2013 or later on Windows, Outlook 2016 or later on Mac, Outlook on the web for Exchange 2013 on-premises and later versions, Outlook on iOS, Outlook on Android, and Outlook on the web and Outlook.com. Not all of the newest features are supported in all clients at the same time. Please refer to articles and API references for those features to see which applications they may or may not be supported in.

Get started building Outlook add-ins

To get started building Outlook add-ins, try the following.

Mac
  • Quick start - Build a simple task pane.
  • Tutorial - Learn how to create an add-in that inserts GitHub gists into a new message.

See also