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 structuredWe’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… match is found, Outlook provides a control that can launch the add-in.
When[When this willhappen:happen:] We will begin rolling this out in mid-May 2024 and expect to complete by mid-June 2024.How[How this will affect yourorganization: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 toprepare:prepare:] To learn how to update your add-ins, see Use regular expression activation …- · first version seen
Learn more
Links from the notice and their documentation checksRelated public changes
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.