Step-by Step guide to run the tool


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.

The article provides step by step guidance on running the migration tool. Before reading the article we advise you to go through, Understand the tool article, which describes concepts of the migration tool.

The tool can be accessed from the Stream admin center or SharePoint admin center from 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: You can either go to Settings to display a message to your Stream (Classic) users or click Launch Migration tool button.

Refer to this section to display a message to your users. And choose the relevant message from our example message ideas and notify users of coming changes directly in the product.

Migration tool Settings page-Stream admin center

Step3: Once you select Launch Migration tool button, you'll land on the Stream connector inside Migration Manager. If you are on global admin cred, it will seamlessly trigger SSO. Otherwise, you would need SharePoint admin credentials. Once you land on the screen, you'll notice first-run experience (FRE) steps and a Take the tour button.

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

Note: If you see a green dot on top right corner of your screen, it shows Stream is successfully connected. If it isn't green, the tool won't work. You may need to add the following URLs to allowlist. and

Scan tab- FRE and shimmer screen

Note: Migration manager tab and hence the Stream connector is soon going to move to Microsoft admin center, but either SharePoint or global admin credentials will work.

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 migrate videos.

Note: It may take up to 15 minutes to load the containers for the first time when you use the tool.

You can also access the Migration tool via Stream connector inside Migration manager from the SharePoint Admin Center. See the below screenshot on this second entry point

Migration manager tab

Step 5: Content will keep loading until 40,000 rows or containers are discovered. Scans tab can load maximum of 50,000 rows. If your organization has more 40,000 container, you'll need to migrate first 40,000, delete those, and then discover remaining containers. Refer to Migration nuances for large customers section below for details.

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- Take the tour enabled

The Scans tab displays one line item for every container that exists in the tenant. If the container has at least one published video. Review your content in the Scans tab to identify which containers to migrate.

Scans tab- teaching bubbles

Scans tab features include:

Feature Description
Summary header Gives an overview of your container data including number of containers, videos inside them, and video sizes.
Add Containers To manually discover containers
Look for new containers Inside ‘Add containers’ pane. Surface any new containers added after the last scan.
Specify single container Inside ‘Add containers’ pane. Add a single container path to discover it manually
Upload a CSV Inside ‘Add containers’ pane. Add multiple container paths in a CSV to discover them manually
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 Scan log and Summarysection for samples report.
Filters Filter containers by Container typeContains meeting recording, and Scan status.
Search Search by Container name and Container path.

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

Scans tab- Container selected

As a container is scanned for videos, its status changes from queuedin-progressfinalizing, to complete.

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 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 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 the content that has been migrated. It will be nil when you land for the first time on this screen
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 does not migrate when all container are selected. It will come handy when you want to migrate all but a few containers
Unarchive button Unarchiving a container allows that container to be migrated
Download logs Download migration logs for videos in a container. For sample report, refer to the Scan log and Summarysection for samples report) section
Filters Filter containers by Migration StatusContains meeting recording, and Container type.
Search Search by Container name and Container path

Step 9: Assign a destination path for a container. Select the Assign destination area for any container and it opens right pane as shown below. Select the destination path from the pane.

Migrations tab- container path assigned

Once you select Save Path, you'll see that destination appears for the container. 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 it 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. And then click Continue from the right pane.

Read the instructions in the right pane. Not all metadata associated with the video migrates. Only critical ones such as Title, description, thumbnails, transcripts and permissions migrate. For complete details, refer to Metadata that migrates with video section.

Migrations tab- container 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.

Note: While a video is migrating, it can be viewed, but your users will not be able to edit it. You can use the in-product messaging feature to convey this information.

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 area on the container row. It will open the side pane and display the destination hyperlink. Select this hyperlink to open the migrated destination. You can play the migrated video from here and verify.

Migrations tab- migrated video link

Stream Migrated videos folder on SharePoint

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 soft delete (or be hidden) from Stream (Classic).

Migrate newly added videos after the container was migrated

  • If you didn't stop the ingestion of video in Stream (classic) before you begin migration, there are chances that new videos can be added after the container has migrated. In this case you don’t need to rescan but simply remigrate the container from Migrations tab.
  • 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, remigrating it may result in duplicate videos 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- Hybrid case

  • Destination path can't 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.
  • The container can partially migrate due to two reasons, either the admin did partial migration (coming soon) or it can happen in a few corner scenarios as well.
    • SharePoint has a max storage quota defined at a site level.
    • The missing videos from the container have migrated to some other container. It can happen in case a video is associated with multiple containers. Refer to Permissions and Location section to understand this case.

Data deletion from Stream (classic)

Once the video migrates to Stream (on SharePoint), the video is ‘soft deleted’ or hidden from Stream (classic). Videos that are left behind will eventually be deleted. Admins can use the disable tenant setting to shutdown access of Stream (classic) for their users. Admins however, will still have access to both classic and migration tool.

Data will be hard deleted permanently from classic both for soft deleted and left-over videos. It will happen 180 days after admin disables the tenant but not before classic end of life.

Migrating Nuance for large customers

This section may be important for your organization if you are a large customer with more than 40,000 containers. Since the tool at any given time can display only 40,000 containers, you need to follow the following steps to migrate correctly

If you plan to migrate all your content, follow the following steps

  1. Click the Launch Migration button from Stream admin center and land on the Scans tab. The auto discovery of the container begins
  2. Migrate all videos, with default destinations or choose your own
  3. Post migration, wait for one day before deleting migrated videos from both Scans and Migrations tab. The wait period will make sure that there is no status sync discrepancy between Stream and Migration manager platform
  4. Discover the next chunk of containers by clicking on Look for new Containers button in right pane, inside Add containers. The number of new containers added in the subsequent discovery will depend on number of containers remaining from previous chunk. At any given time, the total number of containers in the tool can't exceed 50,000 limit.

See also

Migration details Understand migration tool Migration strategies guide Overview of migrating to Stream (on SharePoint)