Migration Assessment Scan: File Versions

Learn how to fix issues with file versions during migration.


Versions have historically impacted the length of a migration for a given site in a linear fashion. The more versions you have, the longer it will take to migrate a given site.

Note: For FastTrack users: On the target platform, versioning is enabled for all lists and libraries and the default configuration is a maximum of 5 versions per item. To align with this default configuration, migrations will bring over the last 5 versions of a given item.

If you have a business reason to keep more than this number of versions and the report indicates you have a large number of versions across your environment, you will need to provide the business justification. The 500GB per week estimate will not hold true for site collections that contain a large number of versions.

Data Migration

On the target platform, all lists and libraries have versioning enabled with the default value of 5, so the last 5 versions of items will be migrated. The migration schedule would be difficult to predict and consistently deliver if more versions were included, therefore we adhere to the default.

Important: Any site that is configured as “No Access” (locked), in SharePoint will be skipped. To see a list of locked site collections see the Locked Sites scan output.

Preparing for Migration

For FastTrack users: Examine the report and determine if any items with more than 5 versions are required by your business. An example of such a requirement would be legal compliance to retain all versions of a document.

Post Migration

During the site User Acceptance Testing period, site owners should validate their version information was migrated as expected.

Scan Result Reports

FileVersions.csv    This scan report provides a list of all the files in the environment that have versions.




URL to the site collection.


Site collection owner.


Number of versions the items have.


File that the versions are associated with.

Share Facebook Facebook Twitter Twitter Email Email

Was this information helpful?

Great! Any other feedback?

How can we improve it?

Thank you for your feedback!