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


The migration tool is under preview with a few customers and we are gradually increasing the participation into the program. If you wish to try the tool, sign up via the form below and we will put you on a wait list. When the tool is deployed on your tenant, you would receive communication via an email. Smaller customers with less number of videos are given preference, medium and big ones would get to try that later when the tool is more robust & performant .

Register your tenant as wait list here: https://aka.ms/StreamMigrationPreviewSignup

This is the first preview release of the migration tool. We've tried our best to incorporate feedback from many of our discussions with you. Please continue to give us feedback and suggestions as we build out additional features for the tool moving forward. Since the tool is under preview, it may not have complete functionality nor have all the features listed in these help articles. Not all metadata may migrate with videos. Before you start migrating, ensure that you have read and understood the complete documentation. In case you have any further queries/suggestion, please reach out by raising a Microsoft 365 support ticket (mention subject as ‘Stream migration tool’), or providing in-app feedback from within the tool.

In this article, we'll go over the migration process from Stream (Classic) to Stream (on SharePoint), including step-by-step guidance on how to use the migration tool.

The IT-admin led migration process includes three phases—before, during, and after migration.

Before migrating

Migrating content from Stream (Classic) to Stream (on SharePoint) will bring all the goodness of OneDrive for Business and SharePoint (ODSP) features with it. It's imperative to plan our your organization's migration. Understand the tool, communicate with stakeholders, plan to minimize disruption for Business As Usual (BAU), and estimate the time to complete the migration. We recommend you read through all documentation before beginning migration.

Review existing content

The tool is designed so you can migrate only the content you need rather than migrating your entire catalog of content to Stream (on SharePoint). Reports can help you decide which videos are still relevant for your end users by sorting them by Publish Date or last View Date.

Once you have your list of videos to migrate, use it to help estimate the time to complete the migration. This planning is necessary, before you start migrating. Use the reports below:

  • Stream (Classic) Usage Report [Not available in preview]—Assess the number of videos you have as well as each video's data size, ownership, and popularity.
  • **Scan Summary report and logs—Assess the number of containers you have, the number of videos inside each container, their size, etc.
  • Migration Summary report and logs—Monitor migration progress, number of videos migrated, permissions transferred, folders created, and so on.

Get complete information about the reports above by reviewing Migration details.

Understand migration destinations

The Stream migration tool is built on the Microsoft Migration Manager platform. Migration Manager is the go-to tool for migrating any data into SharePoint. Read more about Migration Manager.

Migration Manager works with containers (a group of files or videos) and source and destination connectors. Similar to other cloud connectors, such as Google, Box, or Dropbox, we've built the Stream source connector.

Content in Stream (Classic) is divided into five container types:

  • Microsoft 365 groups (Videos in a group)
  • User containers (Videos in MyContent)
  • Stream group (Videos in Stream group) (if you didn't migrate from office 365 video, your tenant would not have it)
  • Company-wide channel (Videos in company-wide channel)
  • Orphaned container (Videos with no owner) [Not available in Preview]

We'll choose the default destination for some types of containers, 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 (My Content) A user's OneDrive for Business (ODB). A separate “Recordings” folder will be created for old Teams meeting recordings.
Stream-only group None - Admins can choose an existing SharePoint site or create a new one.
Company-wide channel None - Admins can choose an existing site or create a new one. Each company channel will appear as a folder on the site. We recommend Admins divide company channels across multiple new or existing sites to avoid reaching the SharePoint permissions quota limit.
Orphaned content* None - Admins can choose an existing site or create a new one.

*Orphaned containers house orphaned videos, which have no owner. In most cases, all of an organization’s orphaned videos will go in a single container. Organizations with many orphaned videos may have multiple orphaned containers. Orphaned containers will not be available in the preview.

Rules & constraints

  • During preview, only some Stream (Classic) parity features will be available in ODSP. However, we'll continuously release parity and new features after preview launch.

  • Metadata related to features not yet rebuilt in Stream (on SharePoint) won't be migrated and that metadata will be lost. You can’t remigrate a video again later to recover its metadata.

  • To read the latest information on which features are rebuilt in Stream (on SharePoint) and the general status of feature availability, check the "Available features" section below.

  • Permissions between Stream and ODSP differ based on how content is visible and permissions are provisioned. This is especially true for videos associated with multiple groups, Stream groups, and company-wide channels. We plan to mirror a video's permissions between the two platforms. For complete details, read about permissions.

  • Due to permission differences we recommend that you migrate a few test videos and observe permissions on them before migrating real videos.

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

    • Videos that belong to a group: All videos in a group move together. They will be moved to the already existing Microsoft 365 groups 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 land in the user's ODB. Videos for which a group was assigned the viewer and not the owner role will move to owner's ODB.
  • Videos associated with multiple groups will move physically into one location. Permissions are granted to additional groups' members so they can watch videos and access them through search inside ODSP.

  • Once migrated, containers are hidden on Stream (Classic) and are only visible on Stream (on SharePoint).

  • During the preview, all videos in a container will migrate together. However, in the future we may introduce partial container movement where only a few videos from a container migrate. This could be useful in a case where admins need to migrate only videos that are being viewed in their tenant.

  • Once you begin migration, we'll create Stream Migrated Content and Recordings folders in ODSP. The images below demonstrate the file and folder structure creation that will be triggered by migration.

    Note: For the preview phase, these folder names are only available in English.

Files Hierarchy M365 Groups Files Hierarchy Users

Available Features at Preview

To see what features of Stream (on SharePoint) are available during the preview phase and what features are coming in the future, review these articles:

The following migration tool features will be available at preview:

  • Reports:
    • Scan status report, which shows the number of videos in a container.
    • Migration status report, which shows migration progress made.
    • Note: The Stream (Classic) video-level report will not be available.
  • Organization: Videos are organized into users' OneDrive and SharePoint sites. This is the same way you organize other files in Microsoft 365.
  • Metadata: The following basic metadata for a video migrates–Video ID, Name, Created by, Published date, Last modified date, Type of content (Video, Teams meeting recording, or Live event) and Source application. Metadata for features that already exist in OneDrive and SharePoint will migrate.
  • Permissions: Permissions mirror between videos on Stream (Classic) and Stream (on SharePoint).
  • URL support: Existing links to Stream (Classic) redirect to new migrated locations in SharePoint and OneDrive.
  • Embed support:
    • Video embeds won't play inline at the preview. They will display a link, which will play a video from its migrated location. However, video will start playing inline sometime in 2022.
    • Channel embeds won't display inline. The channel embed will display a link to the migrated destination folder.

Preview Limitation

  • Preview is available for tenants worldwide except those in the European Union and China. To try out the tool, admins will need to enroll into the program to try out the tool linked to at the top of this page.
  • Preview will only display 10K of a tenant's containers in the Scans and Migrations tabs. Containers will be visible in this order: Microsoft 365 groups, Stream groups, Company channels, User channels. All Microsoft 365 groups will appear first, in order of last published date, followed by all Stream groups, and so on.
Container name Published date
M365 group A 10/09/2021
M365 group B 04/12/2021
M365 group C 11/04/2020
Stream group A 10/05/2021
Stream group B 05/26/2021
User A 11/02/2021
User B 01/10/2021
  • If your tenant has more than 10K containers (that contain at least one video), we recommend that you try out the tool on your test tenant.
  • When you use the tool for the first time, it may take up to 15 minutes for your Containers to start appearing in the Scans tab.
  • The migration tool preview is currently only set up for English language tenants. Folder names created during migration will be in English. However, non-English tenants can still use the tool in preview. Documentation and in-product text will be localized.
  • “Orphaned” containers aren't available in preview and won't show up in your tenant's discovered content in the Scans tab.
  • The Stream (Classic) report that shows video-level metadata isn't available in preview.
  • At preview, all videos inside a container migrate. We may introduce the ability to migrate only some videos from within a container later.

Migration Enablers

The following features are designed to help admins during the migration process

Display a message to Stream (Classic) end users

You can display a message to your Stream (Classic) end users. It has the following features:

  • A link to Stream (on SharePoint).
  • Ability to show either a default or custom message.
  • Mark-up capability allows admins to include hyperlinks.

Admins can use this to give their end users information about migration and help them navigate to Stream (on SharePoint) to find their migrated content. Use this to display other messages as well, such as informing users that new Teams meeting recordings will save to OneDrive and SharePoint.

Stream Classic End User Message

Ability to clean up old content

Bulk delete makes it easy to clean up content you don’t want to take to ODSP. Read about the bulk delete tool.

delete old content from Stream (Classic)

Best practices before migration

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

  • Deploy the tool on your test or production tenant.
  • Migrate a few test videos including videos associated with multiple groups, users, and Company channels. Verify that they migrate to the correct destinations and folder hierarchy.
  • Try giving unique permissions to a few test videos. Once these videos are migrated, verify the permissions behave as you expected.
  • Try changing destination defaults on some test videos. Though we've tried to make the destination defaults a natural fit, you may have a special use case that needs revising. Review locations and make sure they fit your expectations.

During migration

Below is a step-by-step guide to migration. The UX flow can be accessed from the Stream or SharePoint admin centers inside the Migration manager tab.


You'll need SharePoint or Global admin credentials to access the migration tool.

Step 1: Log on to the Stream Admin Center. Navigate to Stream Migration > Migration tool. Read the documentation and familiarize yourself with the migration process.

Migration tool page-Stream admin center

Step 2: Go to Settings to display a message to your Stream (Classic) end users. Choose the default message we've provided or customize your own. If you choose to customize, use mark up to include any hyperlinks. Settings page- Stream admin center Note: While the option to display a message to users is located under "Migration tool," it can be used to display any message. For example, if you're not yet ready to migrate, you can use this space to inform end users that new Teams meeting recordings will save to OneDrive and SharePoint. Later, when you're ready to migrate, you can update the message to inform users about migration.

Select Save changes to display your message to Stream (Classic) end users. Your message will appear across the top of the screen as shown in the screenshot below. A button gives users the option to go to Stream (on SharePoint). Settings page- message on top

Step 3: Go back to the Migration tool tab and select the Launch Migration tool button to navigate to the tool. Try it out on a test tenant to make sure you understand how the tool works and that your video content is migrating how you expect.

Step4: Once you select Launch Migration tool you'll land on the Stream connector inside Migration Manager. You'll notice first-run experience (FRE) steps as well as a Take the tour button.

The screen will also indicate content is loading as we search your organization for Stream (Classic) content to migrate.

Scan tab- FRE and shimmer screen

Note: You need SharePoint or Global admin credentials to access the Migration Manager screen. If you don't see the above screen, make sure you're logged in with the appropriate credentials.

Once you're in the Stream connector, you'll notice two tabs: Scans and Migrations. The Scans tab lets you review the content in the tenant. Migrations is where you'll actually migrate videos.

Note: It may take up to 15 minutes to load content. We are working to reduce this.

You can also access the Stream connector inside Migration manager from the Sharepoint Admin Center.

All Cloud Connectors page

Step 5: Content will keep loading until all content in your organization is shown in the Scans tab. Once the first set of containers is discovered, the Take the tour button is enabled. Selecting it will display where on screen each action of the migration process takes place.

Scans tab- FRE and take the tour button active Scans tab- teaching bubbles

The Scans tab displays one line item for every container (with at least one published video) that exists in the tenant. Review your content in the Scans tab to identify which containers to migrate. Scans tab features include:

Feature Description
Summary header Gives an overview of your containers' data including number of containers, videos inside them, and video sizes.
Look for new containers Surface any new containers added after the last scan.
Download report Download the Scan summary.
Scan and Stop buttons Discover videos inside containers. These buttons are contextual and appear when individual containers are selected.
Scan log Appears when a container is selected and shows the logs for videos inside that container. Refer to the Migration details report topic for samples of all reports.
Filters Filter containers by Container type, Contains meeting recording, and Scan status.
Search Search by Container name and Container path.

Scan tab- container discovery complete

Step 6: To find videos inside a container, you need to scan it. Select a container and choose Scan Container.

Scan tab- discovered containers selected

As a container is scanned for videos, its status changes from queued, in-progress, finalizing, to complete.

Scan tab- containers scan in-progress Scan tab- containers scan complete

Step 7: After the scan status changes to complete, select Add to Migrations and choose continue from the side pane to add containers to the Migrations tab.

Scan tab-containers being added to migration right pane Scan tab-containers added to migration

Step 8: Once the containers are added, a message appears at the message bar alongside the search button. Navigate to the Migrations tab to review the containers that have been added.

We've automatically mapped the destination paths for some container types like Microsoft 365 groups and users. You can edit them.

Migrations tab FRE Migrations tab FRE minimised

Buttons, Filters, and Search on the Migrations tab perform similarly to how they do on the Scans tab. Migrations tab features include: | Feature | Description | | ----------- | ----------- | | Summary headers | Shows what content has been migrated. The first time you land on this screen all values will appear nil. | | Migrate button | Starts migrating a selected container. | | Stop button | Cancels any in-progress migration. | | Download report button | Downloads the migration summary. | | Archive button | An archived container will still appear in the container list but cannot be migrated. | | Unarchive button | Unarchiving a container allows that container to be migrated. | | Download logs | Download migration logs for videos in a container. For details of all reports, refer to the Migration details report topic. | | Filters | Filter containers by Migration Status, Contains meeting recording, and Container type. | | Search | Search by Container name and Container path. |

Step 9: Assign a destination path for a container. Select the container and choose the destination path from the right pane as shown below.

Migrations tab- Assign container destination Migrations tab- Assign container destination right pane Migrations tab- container path assigned

Bulk upload destination paths with the Upload destination paths button. To do so, use the CSV template linked in the side pane.

Note: While setting destination paths give the path until the document library or a folder inside it. Any other path will cause an error during migration.

Step 10: Select containers you're ready to migrate then select the Migrate button.

Note: In preview, not all metadata associated with a video will migrate and you cannot re-migrate a video later to retrieve lost metadata. To understand what metadata will migrate, View supported features.

Migrations tab- containers selected for migration Migrations tab- containers selected for migration right pane

A container's migration status will update to Complete when it's finished migrating.

Migrations tab- migration status in-progress Migrations tab- migration status complete

Note: While a video is migrating it will be view-only and end users will not be able to edit it. Go to Settings on Stream (Classic) to display a message to your end users, if necessary.

Step 11: Migrated videos are no longer visible on Stream (Classic) but can be discovered on Stream (on SharePoint). To verify that a video has been properly migrated, select any container. This opens the side pane and displays the destination hyperlink. Select this to open the migrated destination. You can play the migrated video from here and verify.

Migrations tab- right pane with destination URL M365 group doc library to verify migrated permissions

Verify the permissions on a video by selecting the triple dots next to it and navigating to Manage access.

Note: It may take up to an hour for migrated content to delete from Stream (Classic). This time will decrease as the tool becomes more robust.

Re-migrating containers

  • If videos are added to a container after the container has already been migrated, you can simply re-migrate the container. Go to the Migrations tab and re-migrate the container from there.
  • During migration we match the file name in the destination folder with the files being migrated. If the name of a file gets edited after its first migration, re-migrating it may result in duplicate vidoes in the destination folder.
  • Migration tool won’t copy a container with the same name twice from Scans to Migrations. See the screenshots below for cases in which a user tries to add previously added containers to Migrations.

Duplicate container- single case Duplicate container- hybrid case

  • Destination path cannot be edited once the container has been migrated. So, the newly added video in a container post migration will also migrate to the same location.
  • In the preview, the complete container migrates, however there may be a few corner cases, which result in migration of only some of the videos from a container
    • SharePoint has a max storage quota defined at a site level. In case that limit is reached, it may result in partial container movement.
    • There may be a case where you could see a few videos missing from a container, even though the container wasn’t migrated. This could happen if a video was associated with multiple containers such as a User, Microsoft 365 group, Company channel, and one of the containers was migrated. Refer to [Permissions and Location](../streamnew/migration-details.md# #permissions-and-location) section for details.

Post migration

Verify migrated videos

If you perform a test or trial run of the tool, manually verify a couple of videos in the ODSP destination location. If you've started migrating to your production tenant rather than using a test tenant, use the following reports to verify the migrated videos:

  • Migration logs: Review a log of migrated content. This log shows each step performed by Mover, including folders created, videos transferred, status (success/fail), and permissions transferred.

  • Migration summary report: Review a container-level summary report. This report shows the status of migrated containers, videos transferred, container and video sizes, folders created, etc.

For samples of all reports, refer to Migration details.

Verify permissions on migrated videos

For the initial testing period, we encourage you to upload test videos, give them unique permissions, migrate the videos, and observe how permissions are transferred. Permissions should be mirrored.

Inform stakeholders

Once your videos are successfully migrated, close the loop and inform your stakeholders about your organization's migration progress 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