Most SharePoint migrations don’t fail because Microsoft “can’t handle it.” They fail because the business moves faster than the plan.
And the risks are usually boring:
- failed migrations
- permission changes
- misconfigured policies
- people and process mistakes
So, if you want a migration that doesn’t turn into a helpdesk bonfire, you need to treat it like a risk and continuity project, not a “copy these folders” task.
Below is the playbook we use.
Step 1: Define “done” in business terms (before you touch a file)
A successful migration is not “everything copied.” It’s:
- People can find what they need
- The right people can access it (and the wrong people can’t)
- The business can keep working during the move
- Recovery is possible if something goes sideways
One quick gut-check: if you’re relying on sync alone as your safety net, you’re confusing convenience with recoverability.
Step 2: Inventory what you have (and what shouldn’t be migrated)
Create a simple inventory with:
- Source location(s): file shares, legacy SharePoint, Teams-connected sites
- Owners (who answer, “Can we delete this?”)
- Data types (HR, finance, legal, client files)
- Sensitivity/compliance requirements
- Last modified date and file counts
Then do the uncomfortable part: cleanup.
Every ROT (redundant, obsolete, trivial) file you migrate becomes a permanent tax on search, storage, and governance.
Step 3: Fix the “silent killers” before you migrate
File path + filename limits
If you migrate first and discover path issues later, you’ll spend days on weird, “why didn’t this file move?” mysteries.
- SharePoint/OneDrive in Microsoft 365 has a 400-character limit on decoded paths.
- Older systems and apps can still hit lower limits (often 260 characters).
Action: shorten deep folder structures and normalize naming before migration.
Permissions sprawl
Permissions chaos doesn’t “clean itself up” in the cloud. It just becomes cloud-flavored chaos.
Best practice is to:
- Break inheritance as infrequently as possible
- Use groups, not one-off user permissions
Step 4: Design the destination (information architecture first)
If your destination is “one giant library with 40 top-level folders,” you’re importing the same problems with better branding.
Modern SharePoint works best when you intentionally design:
- sites (ownership + security boundary)
- libraries (content grouping)
- metadata (how you filter/find)
- navigation (how humans move)
Microsoft’s guidance on modern information architecture and hub-connected site organization is the right mental model here.
Rule of thumb:
- Security boundaries → separate sites.
- Same audience, different content types → separate libraries.
- Different ways people need to find things → metadata.
Step 5: Map access the right way (roles → groups → permissions)
Do not start by recreating everyone’s current access exactly as-is. That’s how you preserve dysfunction.
Start with roles:
- Leadership
- Finance
- Sales
- Operations
- HR
- External partners (if applicable)
Then map to Microsoft 365 groups/SharePoint groups and grant access at the site/library level where possible.
If you must do unique permissions, do it consciously and document it.
Step 6: Choose the right migration tool (based on your source)
If you’re moving file shares → SharePoint/OneDrive/Teams
Use Migration Manager in the SharePoint admin center. It supports scaling with agents, task-based migrations, and reporting.
If you’re moving SharePoint Server (on-prem) → Microsoft 365
Use the SharePoint Migration Tool (SPMT). Microsoft positions it as a free solution for migrating SharePoint Server content to Microsoft 365.
(And yes, planning/assessment is repeatedly called out as the success factor.)
Step 7: Run a pilot migration (and treat it like a rehearsal)
Pick one department or one content set that is:
- representative
- low-to-medium risk
- owned by someone responsive
Then, validate:
- permissions (real users, not admins)
- search/findability
- file open/edit behavior (Office apps + browser)
- Teams integration (if Teams-connected)
- version history expectations
Then adjust your structure before the big move.
Step 8: Migrate in waves (not one big bang)
A practical wave approach:
- Low-risk shared content (general ops, templates, marketing collateral)
- Departmental sites (sales, operations)
- High-risk / regulated content (finance, HR, legal)
- Executives + assistants (high visibility, high interruption cost)
Each wave should include a:
- migration window
- validation window
- communication plan
- rollback plan (even if rollback = read-only access to the source for X days)
Step 9: Lock the cutover (and prevent “split brain”)
“Split brain” occurs when people keep editing in the old location while you’re migrating, and no one knows which version is the real one.
To prevent it:
- Set the source to “read only” at a defined time.
- Communicate a hard “new home” date.
- Update links in Teams, intranet pages, bookmarks, and SOPs.
Step 10: Protect what you just moved (retention + recovery reality)
SharePoint has recycle bins and retention options, but you need to understand the windows and configure policies intentionally.
For example, deleted items in SharePoint in Microsoft 365 are retained for 93 days (across recycle bin stages), unless purged or constrained by quotas/policies.
That’s helpful, but it’s not the same thing as a tested recovery plan. (This is where a lot of “we use Microsoft” confidence quietly breaks.)
A simple SharePoint migration checklist
- Inventory + owners assigned
- Cleanup plan (what not to migrate)
- Path length and naming remediation
- IA designed (sites/libraries/metadata/navigation)
- Role-based access model + group mapping
- Tool selected (Migration Manager or SPMT)
- Pilot completed + lessons applied
- Waves scheduled + comms drafted
- Cutover plan + read-only date set
- Retention/recovery expectations verified
When it comes to your data, backups, content, and security, it’s always best to have a solid plan. We hope this quick guide will help.
If you need more information or assistance, please contact us today.