Migrate your videos from Stream (Classic) to Stream (built on SharePoint) using Microsoft Migration Manager


The information contained in this topic is meant to provide a preview of the upcoming version of Microsoft Stream which will be launched later this year. Some features, screens, or functionality included in this topic may be modified, replaced, or removed without notice in the final release. Also, any release date mentioned is an estimate and may change.

This topic explains how the migration from Stream (Classic) to Stream on SP will work in the future.


The earlier version of Stream will now be known as Microsoft Stream (Classic) and Microsoft Stream (built on SharePoint) on first mention and Stream (on SharePoint) on subsequent mentions will be the new version.

We've not yet set a retirement date for Stream (Classic). Before doing so, we need to ensure that needed video features are rebuilt in Microsoft 365 and our migration process is in place. When we're ready to announce a retirement date, you'll have plenty of lead time to familiarize yourself with videos in Microsoft 365 as well as explore the migration tool.

The migration tool described below for Stream (Classic) does not yet exist however, it's being actively developed. We're sharing our early plans so you can provide feedback as we progress.

We've divided the IT-admin led migration into three (3) phases—before, during, and after migration—and explained the tasks for each phase.

Before migrating

Migrating content from Stream (Classic) to Stream plays an important role in improving the video experience for your users and brings the goodness of all OneDrive for Business and SharePoint (ODSP) features with it. It involves gathering information, communicating with stakeholders, planning work to minimize disruption for Business As Usual (BAU), and finally, estimating the time to complete it.

Review existing content

An important aspect of planning is reviewing your existing content to decide the videos you need to migrate. Reports can help you build your list. Once you have your list, it will help you estimate the time to complete the migration.

  • Stream (Classic) Usage Report—Use this report to assess the number of videos, amount of data, its ownership, and hierarchy.
  • Scan Summary report and logs—Use this report to assess the number of containers, videos inside them, their size, and so on.
  • Migration Summary report and logs—Use this report to monitor the migration progress, number of videos migrated, permissions transferred, folders created, and so on.

View the Migration details article to get complete information about the above reports

Understand the migration destinations

Here are some basics to help you migrate:

  • We built the Stream (Classic) to Stream (on SharePoing) migration on top of Mover, which is integrated with Migration Manager, the default tool for migrating any data into ODSP.

  • Migration Manager works with containers (a group of files or videos), and source and destination connectors. We built the Stream source connector and are using the existing ODSP destination connector.

  • Content in Stream (Classic) is divided into five (5) containers:

    • Microsoft 365 groups (Videos in a group)
    • User containers (Videos in MyContent)
    • Stream group (Videos in Stream group)
    • Company channel (Videos in companywide channel)
    • Orphaned container (Video, which had no owner)

Learn more about how to use Migration Manager

We'll choose the default destination for each type of container, which admins can override. Below are the “natural” defaults. Admins can change the destination of a single container or use the CSV upload (.csv file) feature to change the destination location in bulk.

Container types Default destination
Microsoft 365 groups Already existing Microsoft 365 Group SharePoint team site. Each channel in the group will become a folder in the default document library for the team site.
User content (MyVideos/MyMeetings) A user's OneDrive for Business (ODB) account that includes video on demand and recordings folders will store ODB for Teams meetings recordings.
Stream-only group None—Admin needs to choose an existing SharePoint site)
Companywide channel* Blank (user needs to choose an existing site, but all company channels are put under one site with folder for each one)
Orphaned content* Blank (user needs to choose an existing site)
  • For these two types, only a single container is allowed. The rest of the containers can have multiple (one for each group/user in a tenant.)

Rules & constraints


When the migration tool is initially launched, it won't be able to migrate all the metadata from a Stream (Classic) video, channel, or group.

  • As we begin, only some Stream (Classic) features will be available in ODSP however, we'll continuously release new features after launch.

  • Metadata related to features not yet rebuilt in Stream (on SharePoint) won't be migrated.

  • If you migrate your Stream (Classic) content, you can't remigrate it later so unsupported metadata will be lost.

  • To read the latest information on which features are rebuilt in Stream (on SharePoint) and the general status of feature availability, check out our roadmap.

  • There are fundamental differences in the permissions between Stream and ODSP, based on how content is visible and permissions are provisioned, especially on videos associated with multiple groups, Stream groups, and companywide channels. However, we'll still maintain the same access level for a file between the two platforms by breaking inheritance. For complete details, read about permissions.

  • Here are a few constraints on moving videos that belong to a group or user content:

    • Videos that belong to a group: All videos in a group move together hence, they will be moved to the already existing Microsoft 365 group or any other site chosen by the admins.

    • Videos that belong to a user: Only videos not associated with a group or channel will be moved to user content and will land in the user's ODB as mentioned in the above table.

  • Videos associated with multiple groups will move physically into one (1) location. Permissions are granted to the secondary owners so they can watch videos and access them through search inside ODSP.

Available features

These are the features that will likely be available when the migration tool launches around Q3 CY2021. This is a tentative list that may contain a few more features later.

  • Basic video metadata migrated: title, description, creation date, created by user
  • Permissions access for each migrated video remains the same after migration
  • Link and embed codes will redirect to the new location after migration
  • Improved video playback and video player
  • SharePoint and OneDrive admins can manage videos like they can other files
  • Embedding videos into SharePoint pages via File Viewer & Highlighted Content web parts
  • Ability to get back to your videos across Microsoft 365 from stream.office.com

Migration settings

Admins can use the following settings to migrate their organization’s content efficiently and help their respective end users, too.

  • Clean up old content—You can choose a date. No content published before this date will be selected for migration.

    Clean up old content from Stream (Classic)

  • Display message on Stream (Classic)—You can display a message to your end users on Stream (Classic) when you have enabled migration for the content. It will:

    • Have a link to Stream (on SharePoint).

    • Give end users any information about migration that you may want to convey.

    • Help them find any content that may have migrated. The link to Stream (on SharePoint) will help them find the content they were looking for.

    • Have default text here, which admins can over-ride.

      Display a custom message to users

Best practices before migration

We recommend the following best practices to help you migrate your content seamlessly:

  • Try migrating some test content first. Choose the destination and verify the location in ODSP.
  • Try giving unique permissions to the video and verify the permissions getting mirrored.
  • Try changing the destination defaults. Though the defaults should be a natural fit, you might have a special use case where the defaults don't work for you. If so, then the bulk destination Excel upload will help.

During migration

Below is a step-by-step guide to migrate your content. The UX flow begins with the Microsoft Stream Admin Center and moves on to the SharePoint Admin Center.


You'll need SharePoint admin or, Global admin and Stream admin credentials, to complete the following steps. Before you start, make sure you read the Before migrating section and follow our advice there.

Step 1: Log on to the Stream Admin Center. Navigate to Stream Migration > Migration tool. Turn on the Migration switch and click Save. As soon as you turn on migration, the setting on the next tab is also turned ON.

Stream Admin Center

Step 2: Before you click the Migration Manager button (which was enabled in the last step), you can:

a. See other tabs that are already turned on to help you prepare for migration

b. Review the migration Settings and Reports tab that is already available

  • Identify a "no migrate" date—a beyond which you may not want to migrate the content (available in the Migration settings)

  • Use the Usage Report (available in the Reports tab) to estimate the amount of storage you'll need and approximate time you’ll need to migrate the whole content set

Admin center features

Step 3: Set a "no migrate" date in Migration settings, as mentioned in Step 2, if needed, and turn on the message in Stream (Classic). We advise you to do it unless you are playing with the tool or migrating test content since it will start showing the below message to your users. We've added a default message, but you can customize one for your users.

Set a no migrate date

Turn on message for users


This is how the message will appear on the Stream (Classic) portal to your end users.

Message banner in Stream

Step 4: Return to the Migration tool tab and click Migration Manager. You will land on the Stream source connector inside Migration Manager. On the Scan tab of the tool, the first scan will automatically search for content. It will populate all the videos in the tenant and divide them into the five (5) types of containers defined above. The Scan tab helps you review the content in your tenant and identify the containers to migrate.

Migration Manager walkthrough

Find below the description of the page:

Feature Description
Headers Describes the videos in your tenants. It mentions the containers, videos inside them, and total size.
Buttons on the top Click Look for new containers if you are migrating for a second or more times. This function will surface any new containers added after the last scan. The Scan and Stop buttons appear on individual containers and can be used to discover any new videos added in them after the last scan. You can download the Scan summary from the Download report button on the top. The Scan log is available at a container level, once you select one. Refer to the Migration details report topic for samples of all reports.
Filters Works on Source type and Scan status columns
Search Works on Stream source and Source path columns

Scan tab on Migration Tool


If you have different Stream and SharePoint administrators in your organization, you will need SharePoint admin or global admin credentials to access the Migration Manager. Once you log in with the required credentials, click the Migration tab in the SharePoint Admin center. Under this tab, you will see the Stream connector as shown below.

Migration tab

Step 5: Now that you've identified containers to move using the Scan tab and reviewed the reports available there, you can start to migrate a few containers. Make a selection and click Add to migrate from the top header, then click same button from the side panel.


If you are testing the tool for the first few times, we recommend you migrate some test containers.

Add to migrate button

Step 6: The selected containers from the previous screen are copied to this new Migrate tab. On this tab, the columns are different and you can see the destination location for the containers. Look for the default destinations provided for some of the containers. For the containers without defaults, you can choose a new or existing site.

Migration tab on Migration Manager

Find below the description of the page:

Feature Description
Header Header line shows the summary of the content migrated till now. The first time you land on the screen, all values appear as zero until you successfully migrate some containers.
Buttons on top Migrate starts migrating a selected container. Stop cancels the ongoing migration task. Archive is if you don't want to migrate the container. It appears once you've selected a container. You can download the Migration summary from the Download report button. The Migrate log is available at a container level once you select one. Refer to the Migration details report topic for details of all reports.
Filters Work on Migration Status and Source type columns
Search Works on Container name, Source type, and Stream path columns

Step 7: If the defaults don't work for you, you can change the destination for a single container. Click the Destination column value, then click Edit (from the right pane) to choose the desired location in the flow.

Change default destination

Edit destination

To bulk upload the destinations:

  1. Click Upload destination path.
  2. Download the Excel report from the right panel. The source and destinations on the screen will be pre-filled and you can edit any destination or enter a new one for empty locations.
  3. Click Save to upload the destinations.

Bulk upload

Step 8: Once you have chosen the desired destination location for the containers, select the containers you want to move and click Migrate. The status of the container changes to “In-progress” first and then to “Complete” once the migration is finished. The total number of videos and GBs of data transferred for each container is visible on the panel.

Selected container

Migrate containers


Before you click Migrate in the above step, all the content is available to your end users for viewing and editing. After the migration starts, the container is locked for editing, but end users can still see the videos in them. You can also Stop the migration once it is in process, if necessary.

View containers

Migrate containers in Stream


Before you click Migrate in the above step, all the content is available to your end users for viewing and editing. After the migration starts, the container is locked for editing, but end users can still see the videos in them. You can also click Stop to halt the migration once it is in process, if necessary.

Stop migration

Post migration

Verify migrated videos

If you perform an initial test or trial run of the tool, go ahead and manually verify a couple of videos in the ODSP destination location. If you have started moving your real videos, you will not have time to verify each of them, so use the reports to help you verify the migrated videos.

Refer to the below-mentioned reports or find complete details in the Migration details report topic for samples of all reports.

  • Migration logs: Review a log of the migrated content. It shows each step performed by Mover. For example, each folder created, video transferred, its status (success/fail), and the permissions set for each video.

  • Migration summary report: A container level summary report. It shows the status of migrated containers, videos transferred, its size, folder created, etc. thus, you can track the progress of the migration project.

Verify permissions on moved videos

For the initial testing period, we encourage you to upload a test video, give it unique permissions, migrate the video, and observe how permissions got transferred. Permissions would be mirrored as far as possible. The Migration logs mentioned above provides details of the permissions transferred on each video as well.

Inform stakeholders

Once all the videos are successfully migrated, make sure to close the loop and inform your stakeholders about the progress made and next steps.

See also

Migration details

Overview of migrating to Stream (on SharePoint)

More information about 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