Overview
When migrating files to Microsoft 365 (OneDrive and SharePoint), you need to be aware of file name and path length limitations. These restrictions are imposed by Microsoft and apply to all files stored in SharePoint and OneDrive.
Quick Reference
File Name Limits
The migration tool enforces a 200-character maximum for file names, including the file extension.
Example
Very_Long_Report_Name_For_Quarterly_Financial_Summary_Including_All_Departments_And_Subsidiaries_With_Appendices_And_Supporting_Documentation_Fiscal_Year_2024_Final_Version_Approved_By_Board_Of_Directors.xlsx
Very_Long_Report_Name_For_Quarterly_Financial_Summary_Including_All_Departments_And_Subsidiaries_With_Appendices_And_Supporting_Documentation_Fiscal_Year_2024_Final_Version_Approved_B.xlsx
Extension Preserved
File Path Limits
Complete file paths (folder structure plus filename) are capped at 400 characters. This includes:
- The site or drive URL
- All folder names in the path
- The file name with extension
Truncation Handling
When a file's path exceeds the 400-character limit, Cloudiway takes special action to ensure the file is still migrated:
zTruncated Folder
Files that exceed the path limit are placed in a special folder named zTruncated at the root of the target library. This ensures the file is migrated while remaining compliant with Office 365 restrictions.
After migration, you should:
- Review the contents of the zTruncated folder
- Reorganize files to their appropriate locations
- Shorten folder names or restructure as needed
- Delete the zTruncated folder once all files are relocated
Recommendations
To facilitate smoother migrations and avoid truncation issues:
Shorten File Names Before Migration
Review and reduce lengthy file names in the source before transferring data.
Simplify Folder Hierarchies
Reduce nesting depth and shorten folder names to minimize overall path lengths.
Run Path Analysis
Before migration, scan your source for files that may exceed limits and address them proactively.
Consider Target Structure
Plan your SharePoint site and library structure to minimize additional path length added by the target.