MC1558030: Microsoft OneDrive for Windows and Mac: node_modules folders will be excluded from sync by default

Published . Last updated .

Microsoft 365 Message Center announcement MC1558030.

MS Message Center's Summary

Microsoft is updating OneDrive for Windows and Mac to exclude new folders named node modules from cloud syncing by default starting December 14, 2026. This change aims to improve performance by preventing the synchronisation of large numbers of small dependency files. Existing synced folders will remain unaffected. Administrators who require these folders to continue syncing must configure the appropriate OneDrive policies before the rollout begins.

Administrator impact
Review existing OneDrive sync policies and update developer guidance before December 14, 2026, if your organisation requires node modules folders to sync.
End user impact
New node modules folders will remain local to the device and will not sync to the cloud or other devices without admin policy intervention.
Importance
3/10: This is a planned configuration change that affects developer workflows and requires administrative action only if the default exclusion needs to be disabled.

Deploy and configure the OneDrive sync app for Mac

Use OneDrive policies to control sync settings

Microsoft Summary

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 ID
MC1558030
Category
plan For Change
Severity
normal
Services
Microsoft OneDrive
Tags
Feature update, User impact, Admin impact
Expires
Action required by

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_modules folders 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_modules folders: OneDrive will exclude newly created folders named node_modules from 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_modules folders: 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

Compliance considerations

No compliance considerations identified. Review as appropriate for your organization.