Whiteboard: existing Azure board migration to ODB storage

Updated August 12, 2025: We have updated the timeline. Thank you for your patience.

As outlined in MC677236 (July 2024), Azure to OneDrive migration of existing Whiteboards has now started and will reach your tenant (if you haven’t received it already) in the coming months, before June 2025. Complete details can be found in this support article: Migration of Whiteboards from Azure to OneDrive - Microsoft Support.

Action for admins: The migration affects only Microsoft Azure-based Whiteboards. If your tenant does not have any Azure Whiteboards, this migration does not impact you. Check if your tenant has Azure Whiteboards using this PowerShell cmdlet: - Get-WhiteboardsForTenant

Action item for users: Until the migration completes. When your tenant receives the migration code, users can trigger a migration by starting a Whiteboard session from a web browser by simply going to https://whiteboard.microsoft.com/ or by using a Whiteboard in their Teams meetings.

Whiteboard previously stored whiteboard files in Azure storage. In 2022, Whiteboard switched to OneDrive as the storage location for most newly created boards. We made a client-based migration available for your organization, which is currently rolling out gradually. 

This message is associated with Microsoft 365 Roadmap ID 117394.

When this will happen

The client-based migration experience started in December 2024 (previously July), and we expect to complete the migration by late August 2025 (previously early August).

How this will affect your organization

Any user who launches an eligible Whiteboard client (Whiteboard on Windows, Whiteboard in Teams desktop/web) will automatically kick off a non-blocking migration of all their whiteboards. Depending on how many whiteboards they have, on average the process will take between a few seconds to a few minutes.

The migration will provide many benefits for your organization and users on the migrated boards, including:

• Features unique to whiteboards stored in OneDrive, such as Follow, Commenting, and more.
• Improved performance on whiteboards now stored in OneDrive.
• Improved compliance and security associated with whiteboard being stored in OneDrive.

There is no possibility to delay the migration.

What you need to do to prepare

The migration will happen naturally and automatically for most users in your organization with no disruption, but please ensure that users are aware they need to launch Whiteboard in one of the previously mentioned clients in order to keep their content prior to the conclusion of the migration.

In the unlikely case that a user’s whiteboards fail to migrate, they will see an error banner. We will attempt to migrate the board again in 30 days. If the board contains important information, we recommend the user copy the content to a new whiteboard.

Users will be able to see which boards have not migrated in a dedicated section on the board picker. Admins will be able to verify what whiteboard content remains in Azure and obtain the userIDs via our PowerShell cmdlets, if you wish to proactively notify users to get their content.

Complete details about the migration can be found in Migration of Whiteboards from Azure to OneDrive - Microsoft Support, including how start and completion of migration will be notified, how errors will be communicated, and the new PowerShell cmdlets.