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


The migration tool is now available under public preview to all customers except those in GCC and some customers whose Stream (Classic) tenant is in the USSO and CACT data centers (some customers in US, Canada, West Indies, & South, Central, & Middle America). The timeline to enable the tool in GCC is still to be determined. If your tenant maps to the data center USSO or CACT that doesn’t have the tool enabled, you’ll see errors when you try and run the tool. We are working to resolve the problems with these specific data centers as fast as possible.

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:

  • We’ll announce the retirement date of Stream (Classic) when the migration tool graduates from public preview to general availability. (See timeline details below.) From the time of the retirement date announcement, you’ll have:

    • One year to migrate your content before Stream (Classic) is retired
    • Three months before new videos will be required to be uploaded to Stream (on SharePoint), with the option to delay this requirement an extra three months
    • Eight months before Stream (Classic) is automatically disabled for users with the option to delay this disablement an extra four months
  • 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 - October 10, 2022

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



  • Estimate early Q1 CY2023 - Retirement date notice
    • Stream (Classic) retirement date announcement
    • Migration tool enhancements:
      • Allow filtering of videos moved in a container to allow cleanup of unused content during migration
      • Single video embed codes redirect and play inline
      • New settings added to schedule/delay blocking of uploads & tenant disablement
  • Retirement date notice + 3 months - No new videos can be uploaded to Stream (Classic) unless you take action to delay this change
  • Retirement date notice + 6 months - No new videos can be uploaded to Stream (Classic) for any customers
  • Retirement date notice + 8 months - Users no longer able to access or use Stream (Classic) unless you delay this change
  • Retirement date notice + 12 months - Stream (Classic) is fully retired & automatically disabled
    • Users no longer able to access or use Stream (Classic)
    • Service shutdown will begin
    • Any remaining content in Stream (Classic) that wasn't migrated will begin being deleted
  • Retirement date notice + 24 months - Stream (Classic) links and embed codes will no longer redirect to the migrated videos in OneDrive & SharePoint

NOTE: GCC will follow a similar schedule to the above 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