(Updated) OneDrive for Business: Improved Windows Desktop sync error messages for max path length

OneDrive for Business on Windows will improve sync error messages for file paths exceeding 520 characters, guiding users to rename or move items without stopping sync. Rollout starts mid-August 2026, requiring no admin action but reducing support tickets and troubleshooting time.

2026-08-03T21:31:49.647Z

<p>Updated August 3, 2026: We have updated the timeline. Thank you for your patience.</p><p><b>[What and why]</b></p><p>We are improving the OneDrive sync experience on Windows desktop to provide clearer, more actionable guidance when file and folder paths exceed the supported 520-character limit. The updated experience will show exactly how many characters a path exceeds the limit and will provide a guided flow to rename or move affected items so they can sync successfully.</p><p>This improvement addresses a common OneDrive sync issue by reducing user confusion, minimizing workflow disruption, and helping users resolve errors faster.</p><p>This update is associated with Microsoft 365 Roadmap ID <a href="https://www.microsoft.com//microsoft-365/roadmap?filters=&amp;searchterms=557563" target="_blank">557563</a>.</p><p><b>[Rollout schedule]</b></p><p><b>General Availability (Worldwide): </b>Beginning <b>mid-August 2026</b> (previously late July) and expected to complete by <b>mid-September 2026</b> (previously mid-August)</p><p><b>[Impact on your organization]</b></p><p><i>Who is affected</i></p><ul><li>All users of the OneDrive sync client on Windows desktop</li></ul><p><i>Platforms and services</i></p><ul><li>OneDrive for Business (Windows desktop sync client)</li></ul><p><i>What will happen</i></p><p>Max path errors are one of the most commonly reported issues by OneDrive sync users. Currently, when a file or folder path exceeds the 520-character sync limit, the error message only states how many characters the path exceeds the limit and asks users to shorten it. In addition, File Explorer limitations may prevent users from renaming paths over 260 characters, and the sync client may stop syncing until the issue is resolved.</p><p>As part of this improved error experience, when users encounter max path errors, the sync client will continue running and users will be guided through a custom rename and move experience.</p><p>With this update:</p><ul><li>The sync client will continue running when users encounter max path errors</li><li>Users will be guided through a custom rename and move experience to resolve issues directly</li></ul><p>The rename experience will:</p><ul><li>Show the number of over-limit characters</li><li>Highlight which items in the path can be renamed</li><li>Allow renames even when the path exceeds 260 characters</li></ul><p><i>Screenshot - Custom rename dialog</i></p><img src="https://support.microsoft.com/en-us/customercomms/media/messagecenter/2026/07/19984-1.png"><p>The move experience will:</p><ul><li>Show over-limit character counts in a guided interface</li><li>Display warning dialogs for over-limit shared items in OneDrive</li><li>Display warning dialogs for over-limit items in shortcuts</li></ul><p>Screenshot - <i>Example warning dialog for overlimit items in shortcuts</i></p><p><img src="https://support.microsoft.com/en-us/customercomms/media/messagecenter/2026/07/19984-2.png"></p><p>These enhancements are designed to reduce troubleshooting time and improve the overall sync experience.</p><p><b>[Action required and recommendations]</b></p><p>No admin action is required. This update will be automatically available through the OneDrive sync client.</p><p>You may want to:</p><ul><li>Inform your helpdesk and support teams about the improved error messages, as this update should reduce max-path-related support tickets.</li><li>Update internal documentation for resolving OneDrive sync issues if applicable.</li></ul><p><b>Learn more</b></p><ul><li><a href="https://support.microsoft.com/OneDrive/fix-lengthy-paths-to-sync-onedrive" target="_blank">Fix paths that are too long to sync in OneDrive | Microsoft Support</a></li><li><a href="https://support.microsoft.com/onedrive/restrictions-and-limitations-in-onedrive-and-sharepoint#filenamepathlengthsRestrictions" target="_blank">Restrictions and limitations in OneDrive and SharePoint | Microsoft Support</a></li></ul><p><b>[Compliance considerations]</b></p><p>No compliance considerations identified. This update does not change how customer data is stored, processed, or accessed.</p>

OneDrive for Business on Windows will improve sync error messages for file paths exceeding 520 characters, guiding users to rename or move items without stopping sync. This update, rolling out late July to mid-August 2026, reduces confusion and support tickets with no admin action required.

2026-07-20T23:27:15.107Z

<p>Updated July 20, 2026: We have updated the timeline. Thank you for your patience.</p><p><strong>[What and why]</strong></p><p>We are improving the OneDrive sync experience on Windows desktop to provide clearer, more actionable guidance when file and folder paths exceed the supported 520-character limit. The updated experience will show exactly how many characters a path exceeds the limit and will provide a guided flow to rename or move affected items so they can sync successfully.</p><p>This improvement addresses a common OneDrive sync issue by reducing user confusion, minimizing workflow disruption, and helping users resolve errors faster.</p><p>This update is associated with Microsoft 365 Roadmap ID <strong><a href="https://www.microsoft.com//microsoft-365/roadmap?filters=&amp;searchterms=557563" rel="noopener noreferrer" target="_blank">557563</a></strong>.</p><p><strong>[Rollout schedule]</strong></p><ol><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span><strong>General Availability (Worldwide):</strong> Beginning <strong>late July 2026</strong> and expected to complete by <strong>mid-August 2026</strong></li></ol><p><strong>[Impact on your organization]</strong></p><p><em>Who is affected</em></p><ol><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span>All users of the OneDrive sync client on Windows desktop</li></ol><p><em>Platforms and services</em></p><ol><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span>OneDrive for Business (Windows desktop sync client)</li></ol><p><em>What will happen</em></p><p>Max path errors are one of the most commonly reported issues by OneDrive sync users. Currently, when a file or folder path exceeds the 520-character sync limit, the error message only states how many characters the path exceeds the limit and asks users to shorten it. In addition, File Explorer limitations may prevent users from renaming paths over 260 characters, and the sync client may stop syncing until the issue is resolved.</p><p>As part of this improved error experience, when users encounter max path errors, the sync client will continue running and users will be guided through a custom rename and move experience.</p><p>With this update:</p><ol><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span>The sync client will continue running when users encounter max path errors</li><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span>Users will be guided through a custom rename and move experience to resolve issues directly</li></ol><p>The rename experience will:</p><ol><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span>Show the number of over-limit characters</li><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span>Highlight which items in the path can be renamed</li><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span>Allow renames even when the path exceeds 260 characters</li></ol><p>Screenshot - <em>C</em><em style="color: black;">ustom rename dialog</em></p><p><img src="https://support.microsoft.com/en-us/customercomms/media/messagecenter/2026/07/19984-1.png"></p><p>The move experience will:</p><ol><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span>Show over-limit character counts in a guided interface</li><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span>Display warning dialogs for over-limit shared items in OneDrive</li><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span>Display warning dialogs for over-limit items in shortcuts</li></ol><p>Screenshot - <em>Example </em><em style="color: black;">warning dialog for overlimit items in shortcuts</em></p><p><img src="https://support.microsoft.com/en-us/customercomms/media/messagecenter/2026/07/19984-2.png"></p><p>These enhancements are designed to reduce troubleshooting time and improve the overall sync experience.</p><p><strong>[Action required and recommendations]</strong></p><p>No admin action is required. This update will be automatically available through the OneDrive sync client.</p><p>You may want to:</p><ol><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span>Inform your helpdesk and support teams about the improved error messages, as this update should reduce max-path-related support tickets.</li><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span>Update internal documentation for resolving OneDrive sync issues if applicable.</li></ol><p><strong>Learn more</strong></p><ol><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span><a href="https://support.microsoft.com/OneDrive/fix-lengthy-paths-to-sync-onedrive" rel="noopener noreferrer" target="_blank">Fix paths that are too long to sync in OneDrive | Microsoft Support</a></li><li data-list="bullet"><span class="ql-ui" contenteditable="false"></span><a href="https://support.microsoft.com/onedrive/restrictions-and-limitations-in-onedrive-and-sharepoint#filenamepathlengthsRestrictions" rel="noopener noreferrer" target="_blank">Restrictions and limitations in OneDrive and SharePoint | Microsoft Support</a></li></ol><p><strong>[Compliance considerations]</strong></p><p>No compliance considerations identified. This update does not change how customer data is stored, processed, or accessed.</p>

OneDrive for Business: Improved Windows Desktop sync error messages for max path length

2026-07-09T21:51:54.967Z

New feature,User impact,Admin impact

<p><b>[What and why]</b></p><p>We are improving the OneDrive sync experience on Windows desktop to provide clearer, more actionable guidance when file and folder paths exceed the supported 520-character limit. The updated experience will show exactly how many characters a path exceeds the limit and will provide a guided flow to rename or move affected items so they can sync successfully.</p><p>This improvement addresses a common OneDrive sync issue by reducing user confusion, minimizing workflow disruption, and helping users resolve errors faster.</p><p>This update is associated with Microsoft 365 Roadmap ID <b><a href="https://www.microsoft.com//microsoft-365/roadmap?filters=&amp;searchterms=557563" target="_blank">557563</a></b>.</p><p><b>[Rollout schedule]</b></p><ul><li><b>General Availability (Worldwide):</b>&nbsp;Beginning <b>late July 2026</b> and expected to complete by <b>mid-August 2026</b></li></ul><p><b>[Impact on your organization]</b></p><p><i>Who is affected</i></p><ul><li>All users of the OneDrive sync client on Windows desktop</li></ul><p><i>Platforms and services</i></p><ul><li>OneDrive for Business (Windows desktop sync client)</li></ul><p><i>What will happen</i></p><p>Max path errors are one of the most commonly reported issues by OneDrive sync users. Currently, when a file or folder path exceeds the 520-character sync limit, the error message only states how many characters the path exceeds the limit and asks users to shorten it. In addition, File Explorer limitations may prevent users from renaming paths over 260 characters, and the sync client may stop syncing until the issue is resolved.</p><p>As part of this improved error experience, when users encounter max path errors, the sync client will continue running and users will be guided through a custom rename and move experience.</p><p>With this update:</p><ul><li>The sync client will continue running when users encounter max path errors</li><li>Users will be guided through a custom rename and move experience to resolve issues directly</li></ul><p>The rename experience will:</p><ul><li>Show the number of over-limit characters</li><li>Highlight which items in the path can be renamed</li><li>Allow renames even when the path exceeds 260 characters</li></ul><p>The move experience will:</p><ul><li>Show over-limit character counts in a guided interface</li><li>Display warning dialogs for over-limit shared items in OneDrive</li><li>Display warning dialogs for over-limit items in shortcuts</li></ul><p>These enhancements are designed to reduce troubleshooting time and improve the overall sync experience.</p><p><b>[Action required and recommendations]</b></p><p>No admin action is required. This update will be automatically available through the OneDrive sync client.</p><p>You may want to:</p><ul><li>Inform your helpdesk and support teams about the improved error messages, as this update should reduce max-path-related support tickets.</li><li>Update internal documentation for resolving OneDrive sync issues if applicable.</li></ul><p><b>Learn more</b></p><ul><li><a href="https://support.microsoft.com/OneDrive/fix-lengthy-paths-to-sync-onedrive" target="_blank">Fix paths that are too long to sync in OneDrive | Microsoft Support</a></li><li><a href="https://support.microsoft.com/onedrive/restrictions-and-limitations-in-onedrive-and-sharepoint#filenamepathlengthsRestrictions" target="_blank">Restrictions and limitations in OneDrive and SharePoint | Microsoft Support</a></li></ul><p><b>[Compliance considerations]</b></p><p>No compliance considerations identified. This update does not change how customer data is stored, processed, or accessed.</p>