Microsoft OneDrive for Windows and Mac: node_modules folders will be excluded from sync by default
In brief
Starting December 14, 2026, OneDrive for Windows and Mac will exclude new folders named "node_modules" from syncing by default to improve performance. Existing synced folders remain unaffected. Administrators can disable this exclusion via policy if needed. No user prompts will occur, and local folder use continues.
Message Center announcement
What and why
We are updating the OneDrive sync app for Windows and Mac to exclude new folders named node_modules from syncing by default, beginning December 14, 2026. This change extends OneDrive's existing default exclusion list, which includes .db-wal files, as mentioned in MC1457838 on October 5, 2026.
JavaScript and Node.js projects can generate tens of thousands of small dependency files in node_modules folders. This change is intended to improve sync performance and reduce unnecessary storage and bandwidth usage. Developers can rebuild these folders using their package manager.
Rollout schedule
- General Availability (Worldwide): Rollout will begin on December 14, 2026, and is expected to complete by mid-January 2027.
Impact on your organization
Who is affected
- Users with work or school accounts who create
node_modulesfolders in OneDrive-synced locations, including Desktop and Documents folders managed through Known Folder Move.
Platforms and services
- OneDrive for Windows
- OneDrive for Mac
What will happen
- New
node_modulesfolders: OneDrive will exclude newly created folders namednode_modulesfrom syncing by default. These folders will remain on the device and will not upload to OneDrive. - Folder name matching: The exclusion applies to folders named exactly
node_modules, regardless of capitalization. - Existing
node_modulesfolders: Folders that are already syncing will continue to sync. OneDrive will not remove existing content from the cloud or devices. - User experience: Users will not receive prompts. Excluded folders will continue to function locally but will not be available through OneDrive on the web or other devices.
- Administrative controls: Administrators can use existing OneDrive sync policies to turn off the default exclusion list if their organization needs these folders to sync.
Action required and recommendations
No action is required if your organization wants to use the new default behavior. If your organization needs node_modules folders to continue syncing, configure the appropriate OneDrive sync policies before December 14, 2026.
We recommend that you update your helpdesk and developer guidance to reflect the new default behavior and notify developers who maintain code projects in OneDrive-synced locations.
Learn more
- Deploy and configure the OneDrive sync app for Mac - SharePoint in Microsoft 365 | Microsoft Learn
- IT Admins - Use OneDrive policies to control sync settings - SharePoint in Microsoft 365 | Microsoft Learn
Compliance considerations
No compliance considerations identified. Review as appropriate for your organization.
