Version History Frequently Asked Questions and Troubleshooting

November 11, 2026 15:47

Note

Links to additional Frequently Asked Questions (FAQs) can be found at the end of this guide.

This article answers common questions about how SharePoint Sites migrations handle Version History, including which versions are preserved and how they appear in the destination. It also helps you troubleshoot common issues, so you can find out why versions did not migrate as expected and how to fix it.

Version History FAQs

This section answers common questions about how versions are preserved and how they appear in the destination during SharePoint site migrations.

What happens if I leave Document versions to migrate empty?

All available versions of each file are migrated.

Is there still a limit of 25?

No. Any number is accepted. The file own version count is the limit.

Does "including current version" still apply?

Yes. A value of 1 means only the current version.

Will my existing projects change?

No. Every project keeps the number saved in it. A project moves to all versions only if someone clears the box and saves.

Can I get the old behavior back?

Yes. Type the number you want, for example 3.

Why does my migration take longer now?

Migrating all versions moves more data. Enter a number to limit it.

What if I enter a negative number?

It is rejected with the message Versions to migrate must be a positive number, or left empty to migrate all versions.

How can I tell how many versions a project will migrate?

Open the project, then Advanced Options > Source/Destination > Destination panel. A number is the limit. An empty box with the hint showing means all versions.

Version History Troubleshooting

This section describes common issues that can cause versions to be missing or incomplete after migration. For each issue, it explains the likely cause and the steps to resolve it.

Symptom	Cause	Resolution
Only 3 versions migrated	The project has a number saved (for example 3), and saved numbers are not changed	Open the project, clear the box (or enter a higher number), save, and run again
The number of versions to migrate box is empty in the Advanced Options. Is that a bug?	Working as designed	Empty means all versions. The hint text says so
I typed 30 and it migrated fewer	The file has fewer than 30 versions	Check version history on the source file. Nothing is lost
I cannot save 0 or a negative number	The screen requires 1 or more and the server rejects negatives	Use 1 or more, or leave empty for all
Migration now takes much longer or moves more data	The field is empty so all versions migrate	Set a number to limit versions
I cannot see the Document versions field	The project type does not show it	Check the source and destination types
The hint text is not showing	The box contains a value	Clear the box
The Google Shared Drive statistics CSV shows All	The field was empty	Expected

Messages You May See

This section lists the messages you may see during migration and explains what each one means and how to respond.

Message	Meaning and action
Versions to migrate must be a positive number, or left empty to migrate all versions	Leave blank or enter a number greater than 0.

Still need help?

Contact support and include:

the project name and the line item that shows the problem.
the exact message you see, copied as written.
the date and time of the run or pass.
a screenshot of the line item or screen.