Create Outlook add-ins for read forms

Read add-ins are Outlook add-ins that are activated in the Reading Pane or read inspector in Outlook. Unlike compose add-ins (Outlook add-ins that are activated when a user is creating a message or appointment), read add-ins are available when users:

  • View an email message, meeting request, meeting response, or meeting cancellation.


    Outlook doesn't activate add-ins in read form for certain types of messages, including items that are attachments to another message, items in the Outlook Drafts folder, or items that are encrypted or protected in other ways.

  • View a meeting item in which the user is an attendee.

In each of these read scenarios, Outlook activates add-ins when their activation conditions are fulfilled, and users can choose and open activated add-ins in the add-in bar in the Reading Pane or read inspector. The following figure shows the Bing Maps add-in activated and opened as the user is reading a message that contains a geographic address.

The add-in pane showing the Bing Maps add-in in action for the selected Outlook message that contains an address

Bing Map mail app in Outlook.

Types of add-ins available in read mode

Read add-ins can be any combination of the following types.

API features available to read add-ins

See also