As you complete a migration task, ShareGate Migrate generates a reliable migration report to help you assess the success of your migration job and
troubleshoot issues that occurred during the operation.
How-to
The Migration report is generated as your migration progresses, and you can access it at any time.
To find a migration report, select Tasks from the sidebar, then click its title to open it.
Selecting a Copy teams or Copy planner plans task takes you to a copy report screen. Click View copy details to find a detailed report.
To find a Copy teams - Incremental migration report, search for the initial Microsoft Teams migration, click the arrow to expand the initial task, and select the Incremental copy task to open the details.
Understand your Migration report
Your migration report provides a detailed view of which items migrated successfully and which encountered warnings or errors during the copy. Most of the report's columns are self-explanatory. However, the Status column and its values are worth going over.
Status
Success: The item migrated successfully.
Started: The app started copying the item, and the operation is unfinished.
Error: Usually indicates that the app did not migrate an item due to a problem or SharePoint error.
Warning: The app migrated an item with some changes at the destination due to a limitation.
Skipped: The item was skipped (this usually happens with incremental copy).
Note: The Success and Started statuses take significance when copying in Insane mode to a Microsoft 365 destination. Because your items are sent to an Azure storage in your tenant and then imported to the final SharePoint destination, Success means that the item was imported by Microsoft 365 and the app received a confirmation. Started can mean that the item was sent to the Azure storage, and the app hasn't received a confirmation that it was imported to its final destination.
Considerations for errors and warnings
You can double-click on the item to view its details when errors and warnings occur.
You can find more information about the item and links to articles for most errors in the item details.
For more significant migrations, exporting the report and using Excel to analyze the results are recommended.
Manage columns
You can modify the visible columns in your migration report to add or remove information about your migrated items.
Open your migration report in the Tasks screen.
Click the Manage columns icon
Choose which columns you would like to see on your report.
Click Save to apply changes.
Restore default
From the Migration report screen, click the Manage column icon
Select Restore default.
Click Save to apply changes.
Note: Adding or removing columns in ShareGate Migrate will not affect how the report is exported. It will always be exported with all available columns.
Comparing source and destination sizes
Comparing sizes between the source and destination is not a recommended indicator of success.
Differences in SharePoint versions and in the source and destination structures can result in different total sizes at the destination, even when everything has been migrated correctly.
ShareGate measures success by confirming that each listed source item arrived at its destination instead.
If you still want to compare file sizes between the source and destination libraries, we recommend using a custom Document report that includes file sizes rather than the migration report.
To create the custom size report:
Select All reports from the main sidebar.
Click Create custom report.
In the Object type dropdown, select Document.
In the Column section, add Size and Total size (all versions).
Click Save and continue to save the report so you can reuse it later.
Give the report a name and click Save.
Navigate to the source site or library that you want to compare and select it with a checkmark.
Click on Run now.
When it's finished, click Export and save the Excel spreadsheet on your drive.
Repeat the process on your destination, selecting the saved report instead at step (2).
Compare the file sizes between the two reports.
Export your report
You can export your results as an XLSX or CSV file on your drive, or have ShareGate automatically export them to a SharePoint library after your migration.
For more info, see Export your migration report to a drive or SharePoint.