Blog Post

Microsoft OneDrive Blog
5 MIN READ

Making Mac OneDrive Faster and More Reliable

Jack_Nichols's avatar
Jack_Nichols
Icon for Microsoft rankMicrosoft
Jun 10, 2026

OneDrive on macOS is getting a major update to how it syncs! The Native Sync Engine is rolling out to Insiders today with version 26.098. It's up to 2x faster on initial sync and on-disk state changes, uses less CPU, memory, and battery, and removes the hidden cache folder that's been the source of most reliability issues since 2022.

It's the latest in an ongoing effort to make OneDrive feel native on Mac. Earlier this year we shipped a redesigned Activity Center with Liquid Glass and native dialogs, and the Native Sync Engine is a major step in that journey.

The cache folder problem

When we moved OneDrive to Apple's File Provider platform in 2022, we needed a way to bridge the existing sync engine with how File Provider expected things to work. Broadly, there are two parts to OneDrive sync: the sync engine itself, and the code that OneDrive uses to work with files. To support File Provider, we had to change how OneDrive interacted with the file system. However, to reduce risk, we decided to use a hidden cache folder that mirrored your OneDrive contents, so the sync engine could remain largely unchanged.

That cache folder solved the immediate problem and unlocked features like Known Folder Move. Over time, however, feedback and telemetry showed us that it was root cause of many of the reliability and performance issues users have reported since. The Native Sync Engine removes it.

What’s changed

Over the past several years, we’ve been working behind the scenes on the Native Sync Engine. Building it required us to completely rebuild large portions of our code and build a new sync platform that allows OneDrive to work better with the File Provider system.

The Native Sync Engine provides the fastest, most reliable experience we’ve ever delivered on the Mac. It has a simplified architecture, eliminates entire classes of errors, and integrates more deeply with macOS. In our performance testing, the new system is about 2x faster for initial sync and on-disk state changes. It also uses fewer system resources, helping preserve your Mac’s battery life while improving overall responsiveness. We’ve also put the new system through multiple tests that simulate usage well beyond what the average user would ever do, and it has held up extremely well in those scenarios. It’s a massive improvement, and one we are very excited to bring to you.

On the surface, the Native Sync Engine looks and feels very similar to what we had before, but there are a few important changes. Let’s walk through a few of them.

Hidden folders no longer hold data

OneDrive's hidden folders now contain metadata only. Your file data only lives in the OneDrive folder you interact with directly.

There are a few cases where a copy of file data will exist in the hidden folder:

  • Files you've created or changed that haven't uploaded yet. The copy is removed once the file has fully synced to the cloud.
  • OneNote shortcuts and similar "link" file types. These are typically a few hundred bytes at most, and we retain them in the hidden folder indefinitely.
  • Some kinds of macOS packages, such as GarageBand files, .app bundles, and certain older iWork files. Copies of these files are retained for longer than most files.
The Native Sync Engine's metadata folder, for a consumer OneDrive account with about 10,000 items, all available locally. Only using a little bit of space for metadata!

Files and folders are always browsable

Files in a folder used to be created on disk only the first time the folder was accessed. That led to Finder showing "Loading..." while you browsed and apps hanging while they waited for folders to materialize.

Now, every folder and file is always browsable on disk. Navigating your OneDrive folder feels like navigating any other folder. It’s snappy, responsive, and just works.

Note that Files On-Demand is unchanged with the Native Sync Engine. Files you haven't opened remain online-only unless you either open them or mark them Always On This Device.

External drive support

The Native Sync Engine also supports external drives, such as USB drives you can plug into your Mac. If your system and your external drive meet the requirements, all of your files and OneDrive's metadata folder will be placed on this drive. On older versions of macOS and on drives that don't meet the requirements, your files and OneDrive metadata will be stored on the home volume.

Syncing shared folders and libraries

If your organization has disabled the “Sync” button on SharePoint and your users are using “Add shortcut to My Files”, you can skip this section, as you are already in the ideal state!

If you are still using synced libraries, each synced library now appears as its own root in the Finder sidebar, instead of nested under a single tenant entry. Add shortcut to OneDrive remains the modern way to access shared content. Admins can hide the Sync button via aka.ms/HideSyncButton.

Identifying the Native Sync Engine

You can identify whether your Mac is using the Native Sync Engine by inspecting the OneDrive version in the Preferences dialog:

  • If the version ends with a value such as "(26K)", you are running the Native Sync Engine.
  • If the version ends with the version of macOS, you are not yet running the Native Sync Engine. 

 

Mac Sync Settings showing the version number, including the Native Sync Engine build.

Rollout

Starting today, we’ll be gradually rolling out this new experience to our Insiders audience. This rollout will take several weeks to complete. If you aren't already in Insiders and want to try the new update, simply open OneDrive preferences, click on the About tab, and check the box to join the Insiders program. 

Your Mac will upgrade to the Native Sync Engine automatically when it receives the update. It might take a couple of minutes for OneDrive to complete the upgrade, and a little while longer for File Provider to finish with the upgrade, but you can still use your OneDrive while this is taking place.

We would love to hear your feedback, good or bad. Just click “Send Feedback” in the OneDrive Activity Center and share your thoughts!

To learn more, watch the latest Sync Up podcast below:

Updated Jun 11, 2026
Version 2.0

20 Comments

  • Hi Jack_Nichols​, this solution designs works if you have a few synced sites/folders. I have about 40 synced sites and my Finder toolbar is full with all the links generated by new version. The links are not alphabetically sorted which finding the folder by name awful.

    However has tested and approved this design has not properly tested it with a setup where user have a lot of folders.

    Please provide any recommendation to solve this issue.

    • Jack_Nichols's avatar
      Jack_Nichols
      Icon for Microsoft rankMicrosoft

      Thanks for the feedback. Some suggestions:

      1. Avoid using the "Sync" button to sync sites, and instead use the "Add Shortcut to OneDrive" button. This is going to be the best bet, both for usability but also for OneDrive performance and resource usage.
      2. Unsync sites you don't need any longer.
      3. Option/right click -> Remove from Sidebar on sites you infrequently access. You can restore them in Finder settings.
      • Jay_Libove_Fe's avatar
        Jay_Libove_Fe
        Brass Contributor

        Jack_Nichols​  "Avoid using the 'Sync' button" is completely unacceptable.

        "Shortcuts" to OneDrive work only when online with a strong Internet connection.

        The whole reason why "Sync" exists is for reliable off-line working. (Similar to the way Microsoft destroyed Outlook's ability to fully sync an Exchange mailbox locally, in favor of "pretty much can only work online").

        This is not an answer.

        Please return to the real questions, about OneDrive performance and reliability and usability problems, and don't put more lipstick on the pig.

  • kingsleymac's avatar
    kingsleymac
    Copper Contributor

    So I came here from the notification of this update that was just posted in the main Microsoft Admin center.   All great news however it is still a bit confusing on knowing which versions have the new feature.   Just having to manually open the about section to look for an alpha string is not good.  We need a way to know what actual version (and forward) has this built in.   Can anyone tell us like version 26.xxx (and later) has the new feature built in?   That way as admins we can check via our reporting tools and/or look quickly without having to open the app.   Also this article here was written back in June and stated "next several weeks" but in the Admin center it states that the rollout might go through Nov but I assume that means for even the people that are not on the insider version

  • OSINoelle's avatar
    OSINoelle
    Copper Contributor

    Will there be a better way of identifying the new sync version other than the "end of the version string" that isn't actually part of the reported version number? It is very hard to tell from places like the Onedrive Sync app health centre without checking manually with the disconnected versions. I assume the rollout is still going(?) as we have yet to see it across a test group of ~30 users opting in.

    • Jack_Nichols's avatar
      Jack_Nichols
      Icon for Microsoft rankMicrosoft

      Rollout is still going which is why you haven't seen it for all users yet. We're deliberately going slow so we can make sure we have the right bugs fixed and so forth.

      Good suggestion about reporting this in the sync health report. We'll take a look.

  • Bluesky007's avatar
    Bluesky007
    Tin Contributor

    I cannot get it to work on an APFS volume on an external drive. (The shipping OneDrive works fine on that drive.) OneDrive throws an error when it converts to the new format. OneDrive still runs & appears to be okay. One can download files, but they cannot be accessed. The finder window simply spins & files do not appear when attempting to access any folder. 

    • Bluesky007's avatar
      Bluesky007
      Tin Contributor

      an update... version 26.143 fixed the problem. I'm now able to use separate APFS volumes, including those installed on an external drive.

      • fryte's avatar
        fryte
        Copper Contributor

        Is there a way to force an update to 26.143? I've spent hours tearing my hair out trying to fix this being completely broken. I just saw your post but can't see a way to upgrade

  • Great but I would like to know why I can't enable the insider preview. selecting the toggle doesn't do anything and it doesn't show the 26H next to the silicon. please contact me.

     

    • Jack_Nichols's avatar
      Jack_Nichols
      Icon for Microsoft rankMicrosoft

      Hi Steven - toggling that setting will opt you into Insiders, but you will usually need to restart OneDrive for that to take effect. As far as the Native Sync Engine rollout, we are slowly rolling this out across Insiders, so if you don't get it right away in Insiders, it should arrive soon.

  • wroot's avatar
    wroot
    Silver Contributor

    This is the kind of a post i am looking for in this blog. Instead of never ending office hours announcements. Maybe you can move office hours into its own sub community.