Migration Overview - Stream (Classic) to Stream (on SharePoint)


The migration tool is now available to all customers except those in GCC. The timeline to enable the tool in GCC is still to be determined.

If you have questions or feedback about the migration tool you can join our Customer Office Hours to talk directly with our engineering team.

We're merging the powerful capabilities of Stream and SharePoint to bring you native video experiences integrated across Microsoft 365. For more information, see the Stream (on SharePoint) overview.

To help in this transition, we’ve built a migration tool to allow you to move your videos from Stream (Classic) directly into SharePoint and OneDrive to take advantage of Stream (on SharePoint).

Migration summary

The following key points summarize how migration and retirement will work:

  • See timeline details, for which parts of Stream (Classic) will change as it retires.

  • Stream (Classic) and Stream (built on SharePoint) will coexist for an extended period depending on your internal migration plans. You'll be able to acclimate your users to the new experience before migrating all your content.

  • Between now and the Stream (Classic) retirement date you'll have flexibility to migrate your content on your own schedule. You can pick your own migration destinations or use the defaults provided by the tool.

  • Microsoft won't automatically force a migration of your content to Stream (on SharePoint). If you choose not to migrate your content, it will be deleted when Stream (Classic) is retired.

  • Not all content in your tenant needs to move to Stream (on SharePoint). Before you migrate, you might want to audit your video files, and remove or leave behind any stale content. Use the Stream (Classic) inventory & usage report to understand what content in Stream (classic), who owns it, and when it was last viewed.

  • Only admins can use the tool to migrate content. You need to be a SharePoint or global admin to use the migration tool and be a Stream (Classic) or global admin to access the Stream (Classic) migration settings.

  • There isn't going to be an “end-user led” migration option. Users can manually download their videos and reupload them to SharePoint, OneDrive, Teams, and Yammer.

  • Only certain pieces of critical metadata and permissions will be migrated with the videos (title, description, transcripts, etc.) The remaining metadata won't be migrated.

  • Stream (Classic) URLs and embed links will keep working post migration. Links to Stream (Classic) will redirect to the videos in their new destination after the migration.

    NOTE: In public preview of the migration tool, single video embeds will show a link to open the video in a new tab, the redirect won't allow the videos to play in line. We're working to make single video embed redirect and play in line for GA of the migration tool.

Migration & retirement timeline

Last updated - January 11, 2023

NOTE: All future dates and timelines are approximate and may change as we develop our plans further.



  • January 17, 2023 - Stream (Classic) upload page changes to show the option to upload to Stream (on SharePoint) for all customers. Most customers already have this change, this will apply the change to customers that opted out via support ticket.
  • February 15, 2023 - Start of six-month and one year countdown until no new videos can be uploaded and retirement
    • Stream (Classic) migration tool enters general availability
    • Migration tool enhancements
  • May 15, 2023 - No new videos can be uploaded to Stream (Classic) unless admin takes action to delay this change. This can be delayed until August 15, 2023.
  • June 1, 2023 - Migration tool improvements for filtering
  • August 15, 2023 - No new videos can be uploaded to Stream (Classic) for any customers
  • October 15, 2023 - Users no longer able to access or use Stream (Classic) unless admin takes action to delay this change. This change can be delayed until February 15, 2024.
  • February 15, 2024 - Stream (Classic) is fully retired & automatically disabled
    • Users & admins no longer able to access or use Stream (Classic)
    • Any remaining content in Stream (Classic) that wasn't migrated will be deleted
  • February 15, 2025 - Stream (Classic) links and embed codes will no longer redirect to the migrated videos in OneDrive & SharePoint

NOTE: Stream (Classic) live events will be retired on an earlier timeline. We'll give a six-months notice of the retirement of Stream (Classic) live events as soon as the Teams and Yammer live event RTMP encoder option is Generally Available. We anticipate the six-months notice to start sometime in Q1 CY2023.

The migration tool won't be ready for GCC customers in February 2023. We'll follow a similar schedule to the above timeline once the migration tool is available to be used by GCC customers.

Adoption strategies for moving to Stream (on SharePoint)

Before you decide to migrate videos, you should familiarize yourself with Stream (on SharePoint) and how your users will use it. This familiarity is important as there are a differences between the two solutions. When you transition, it's important that your users are aware of these differences. Thus, it's critical that you, your stakeholders, and power users have a good understanding of Stream (on SharePoint). It's recommended that your users start using Stream (on SharePoint) before you begin migration.

In order to help transition your users to use Stream (on SharePoint) instead of Stream (Classic), see the adoption strategies guide.

Understanding the migration tool

The migration tool is part of the SharePoint migration manager. To get started with the migration tool, read about how the mechanics and details of the migration tool work.

Migration strategies

There are several different approaches you can take to moving your users and content off of Stream (Classic) and on to Stream (on SharePoint). The approach or combination of approaches that will work best for you and your organization will depend on your organization size, number of videos in Stream (Classic), your current use of Stream (Classic), and organization culture.

To give you ideas on how you can run your migration read the migration strategies guide.

See also

Migration strategies guide

Adoption strategies guide

Overview of migrating to Stream (on SharePoint)

Migrate your videos from Stream (Classic) to Stream (on SharePoint)

Migration details

Migration tool details

More information on Stream (on SharePoint)

Features and roadmap of Stream (on SharePoint)

Connect with the Stream engineering team to give us feedback and learn more about Microsoft Stream