Public mode

No access to your tenant or devices. Every item links to its source. What this means

Sources need attention Customize Public modeDiscuss ChangeIntel on Discord

Retirement of entities in Outlook for contextual add-ins

From Microsoft 365 Message Center Archive by Merill Fernando · Microsoft may not have sent this notice to your tenant.

What the notice says

Microsoft’s text, safely structured

We’re making some changes to the way Outlook supports contextual add-ins. Contextual add-ins activate based on the content of an email message or a meeting request. Currently, Outlook supports two methods for activating contextual add-ins: entity stamping and regular expression (regex) matching.

Entity stamping is a process where Outlook identifies and highlights certain types of data in a message, such as addresses, phone numbers, meeting suggestions, and task suggestions. When a user clicks on a highlighted entity, Outlook shows a list of add-ins that are relevant to that entity.

Regex matching is a process where Outlook matches the content of a message against a set of regular expressions provided by the add-in developer. When a match is found, Outlook provides a control that can launch the add-in.

When this will happen

We will begin rolling this out in mid-May 2024 and expect to complete by mid-June 2024.

How this will affect your organization

We’re retiring entity stamping and will stop highlighting entities in Outlook. This means that add-ins that rely on entity stamping will no longer activate when highlighted entities are selected. Add-ins that rely on entity stamping, such as Bing Maps, Action Items, and Suggested Meetings, will also be retired. However, we will continue to support regex matching in add-ins and the Join Meeting button in online meeting add-ins.

If you have any add-ins that use entity stamping, you’ll need to update them to use regex matching or the Join Meeting button prior to this change happening. Otherwise, your add-ins won’t activate in Outlook and may lose functionality.

As part of this retirement, the following APIs will stop working for add-ins:

  • getEntities()
  • getEntitiesByType(entityType)
  • getFilteredEntitiesByName(name)
  • getSelectedEntities()

What you need to do to prepare

To learn how to update your add-ins, see Use regular expression activation rules to show an Outlook add-in and Create an Outlook add-in for an online-meeting provider. For more details on the announcement, see Retirement of entity-based contextual Outlook add-ins.

What changed

Between archive captures, newest first
  1. … match is found, Outlook provides a control that can launch the add-in. When[When this will happen:happen:] We will begin rolling this out in mid-May 2024 and expect to complete by mid-June 2024. How[How this will affect your organization:organization:] We’re retiring entity stamping and will stop highlighting entities in Outlook. This … the following APIs will stop working for add-ins: getEntities() getEntitiesByType(entityType)  getFilteredEntitiesByName(name)  getSelectedEntities()  What[What you need to do to prepare:prepare:] To learn how to update your add-ins, see Use regular expression activation …

  2. · first version seen

Learn more

Links from the notice and their documentation checks

No related announcements were found in the saved public history. Check the source for newer announcements.

Not confirmed here

What this page cannot tell you
  • Whether your tenant is affected: this is Microsoft's notice, not a check of your settings.
  • 2 linked pages have not been read yet.
ChangeIntel

An IT change radar: releases, security, known issues, retirements, documentation changes, and service status from public sources. Every item links to supporting evidence; dates and statuses can change after they are read.

Sources read 15 Nov 23:13 UTC · 274 of 275 readable · 250 fully read · 18 waiting for GitHub's hourly limit · documentation 461/469 current