OneDrive sync path-length report Coming soon
Paths too long to sync
Estimates how long each file's path would be on a PC that syncs its library with OneDrive, and lists the ones at or near Windows' limit. A file whose local path is too long does not sync, and users usually find out after the move. Every figure is an estimate: it is built from the profile folder, organisation name and library folder name you give, not read from a PC.
What does it tell you?
- Which files and folders would be too long to sync (260 characters or more on the PC).
- Which are close to the limit (225 or more), so a longer user name would tip them over.
- Optionally, which are long enough (218 or more) to trouble older Office desktop builds.
- Which folder each library is assumed to sync into, and whether it is hidden from search.
How it runs
- Pick where to look. Clicking the tile asks which account to use and how to connect, signs you in if you are not already, and drops you straight on the site list. No feature page asks you to connect a second time. Tick sites, libraries or folders.
- Describe the PCs. Give the profile folder (C:\Users\firstname.lastname by default) and the organisation name as OneDrive shows it, and choose the layout: Add shortcut to My files (the longer, so the default) or the Sync button. Edit a library's folder name if OneDrive names it differently.
- Read the list, then shorten. Shorten folder or file names, move deep folders up, or shorten library and site names before users sync them.
What do you get?
An Excel workbook, named like contoso-onedrive-sync-path-20261120-101500.xlsx, kept in Report History whether or not you save it. One row per file or folder at or near the limit, worst first, with its estimated local path.
Summary sheet
The profile folder, organisation, layout and thresholds used, and the totals.
Findings sheet
Every file or folder at or near the limit, and one row per library.
| Column | Example |
|---|---|
| Severity | Error |
| Rule | Local path too long to sync (estimate) |
| Path | /sites/projects/Shared Documents/Plans/2026/Budget.xlsx |
| Would land at | C:\Users\firstname.lastname\OneDrive - Contoso\Projects - Documents\Plans\2026\Budget.xlsx |
| Characters | 263 |
Rules sheet
The checks and how often each fired.
Locations sheet
Each library or folder read.
Skipped sheet
Only when something could not be read: each location and why.
What do you need?
- Read access to the libraries in scope.
What will it not do?
- It reads and reports. Nothing is renamed or moved.
- The lengths are estimates. A user whose profile folder or OneDrive folder is longer than the one you gave will hit the limit sooner.
- OneDrive's folder naming is not documented by Microsoft. The default folder name for a library is the site title, a dash and the library title, or one title when they match.
- A library that could not be read is named on the Skipped sheet - it is not counted as clean.