MC295027: Rich text and images in Planner task notes

We are adding support for rich text (bold, italics, underline, etc.) and images in the Planner task notes field. This message is associated with Microsoft 365 Roadmap ID 85688.

The Planner task notes field will support rendering rich text formatting (bold, italics, underline, and more) and image previews. Users can insert rich text and images into task notes.

NOTE: We will update this post once we have Microsoft Graph documentation for the new rich text task notes field available.

MC295027: Rich text and images in Planner task notes

When this will happen

We expect to begin rolling out the new rich text task notes field in mid-December and we expect to complete the rollout by early February.

How this will affect your organization

To support this capability, we are introducing a new rich text enabled task notes field in the Planner Microsoft Graph API. This will result in two task notes fields in our API – the new “rich text task notes field” and the existing “plain text task notes field.” When this feature launches, Planner for the Web and for Teams (Tasks app) will support rich text in task notes. Other Planner experiences in iOS, Android, SharePoint, and Power Automate will only support plain text task notes, but we plan to update these apps to support rich text at a later date.

When this feature update is deployed, all existing task notes content will be preserved in the new rich text enabled task notes field, so users will be able to continue viewing and editing notes without interruption.

We will maintain compatibility between the rich text task notes field and plain text task notes field by ensuring both fields’ contents stay in sync.

If a user edits the rich text task notes field, all content is synced to the plain text task notes field automatically. Any rich content is converted to plain text and synced to the plain text task notes field.

If a user edits the plain text task notes field via the Microsoft Graph API or via a client which only supports the plain text field, the contents in the plain text task notes field is synced to the rich text task notes field without modification. Therefore edits to the plain text task notes field will result in the removal of any pre-existing rich text, text formatting, or images in the rich text notes field.

If a user chooses to insert images in the rich text task notes field, a preview of the image will appear in the task notes field. End users should not see any interruption in their Planner experiences. They can continue using task notes as they do today but gain the ability to insert rich text and view image previews in task notes if desired (for Planner experiences which support it).

What you need to do to prepare

If your organization has custom applications interacting with our Microsoft Graph Planner API, make sure to update the apps to support the rich text task notes field as soon as it is available to take advantage of the new notes capabilities. We will maintain support for the existing plain text task notes field in our Microsoft Graph Planner API for at least 36 months.

If your organization has applications or workflows which parse the task notes to trigger logic based off contents in the notes field, we recommend users continue to input only plain text in task notes and not apply text formatting or insert images into task notes. Such apps should also be updated to avoid parsing task notes or applying logic to contents in the task notes as these are not recommended uses of the task notes field in our API.

Learn more

Message ID: MC295027
Published: 29 October 2021
Updated: 29 October 2021
Plan For Change
#NewFeature #UserImpact #Planner