Message CenterMajor changeAction required by Dec 14, 2026

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

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.

More information

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.