Sync files with OneDrive on macOS

When you install the Microsoft OneDrive sync app for Mac, a copy of your OneDrive is downloaded to your Mac and put in the OneDrive folder. This folder is kept in sync with OneDrive.

If you add, change, or delete a file or folder on the OneDrive website or Mac, the file or folder is added, changed, or deleted in your OneDrive folder and vice versa.

To upload files to OneDrive automatically, just save them in your OneDrive folder from an app, or move the files to your OneDrive folder using the Finder. If you installed the OneDrive app on other computers, the files will automatically be added to the OneDrive folders on them, too.

The sync app lets you sync files from your personal Microsoft account, any Microsoft 365 work or school accounts, and even from Microsoft SharePoint sites if your admin enabled it. (If you're the IT admin for your organization, see Enable users to sync SharePoint files with the new OneDrive sync app.)

You can also use the Finder to rename and delete files, create new folders, and move files around in your OneDrive folder. The changes will automatically be made in OneDrive and your other computers that have the sync app installed.

Notes: 

  • OneDrive is supported on macOS devices with Apple silicon through Rosetta 2 emulation. For most users, no additional setup is needed to use OneDrive on a Mac with the Rosetta 2 emulator. On November 10, 2020, Apple announced their new Macs using Apple silicon CPUs. If you're using a Mac that has the Apple silicon processor instead of the Intel processor, some Office features may not be available yet. For more information, see Microsoft 365 and Office 2019 support for Apple silicon

  • As of 1 February 2019, OneDrive only supports new installations on Mac OS 10.12 or newer. For more information, see OneDrive End Of Support Notice.​​​​​​​

Install and set up

If you have signed in to the OneDrive sync app with a Microsoft account (for example, someone@outlook.com), you should already have the sync app and you can skip to step 2 below.

  1. Install OneDrive for Mac.

    Important: If you are currently using the OneDrive Mac Store app, you must first uninstall it before installing the latest build of the sync app. 

  2. Start OneDrive Setup.

Method 1: If you have no accounts signed in to OneDrive

If you're not signed in to OneDrive with any account, start OneDrive to connect a work or school account.

  1. Start OneDrive by pressing cmd+Space to launch a Spotlight query and type OneDrive. This starts OneDrive Setup.

  2. Enter your work or school account and then select Sign in to set up your account.

    Screenshot of the first page of OneDrive Setup

Method 2: If you already have a personal account signed in to OneDrive

If you already have a personal account signed in to OneDrive, you’ll want to add a work or school account in OneDrive Preferences.

  1. Click the OneDrive cloud icon up in your Menu bar, click the three dots to open the menu, and select Preferences.

    Screenshot of setting OneDrive personal preferences

  2. Click the Account tab, and then select Add an Account to start OneDrive Setup.

    Screenshot of adding an account in OneDrive preferences on a Mac

  3. Enter your work or school account and click Sign in.

    Screenshot of the first page of OneDrive Setup

Key parts of OneDrive Setup

There are a few points of OneDrive Setup that are helpful to watch for:

  • When setting up your OneDrive, it has a default location set. However, you can change this during setup. On the This is your OneDrive folder screen, click Change Location.

    Screenshot of the This is Your OneDrive Folder page in Welcome to OneDrive wizard on a Mac

    Select a location where you would like to save your OneDrive files and click Choose this location.

    Screenshot of choosing a folder location in the Welcome to OneDrive wizard on a Mac

    When you see the This is your OneDrive folder screen, you’ll now see a path to the folder you selected. Click Next to continue.

    Screenshot of This is your OneDrive folder screen after choosing a folder in the Welcome to OneDrive wizard on a Mac

  • On the Sync Files from Your OneDrive screen, you can choose the folders you want to sync to your computer, and click Next. This conserves space on your computer, and reduces bandwidth needed for the sync processes.

    Screenshot of the OneDrive setup menu for selecting which folders or files to sync.

  • You’re done! Click Open my OneDrive folder to see your files sync to your folder.

You can find OneDrive up in your Menu bar. You’ll have a cloud icon for every account you’ve connected to OneDrive. So you’ll have one cloud if you’re only syncing a work or school account, one cloud if you’re syncing only a personal account, or two clouds if you’re syncing both.

Screenshot of OneDrive in the menu bar on a Mac after finishing Welcome to Onedrive

Note: Contoso is an example name. You will see the name of your organization.

If you’re on OSX 10.10 or higher, get sync status directly from Finder by enabling Finder overlays in Settings.

First, click the Apple logo in the top left corner of your Mac Desktop and select System Preferences, then select Extensions in the top-level menu (shown in the 3rd row from the top).

Screenshot of system preferences on a Mac

Toggle on the OneDrive Finder Integration to enable Finder overlays.

You’re all set. Open up your OneDrive folder in Finder to see overlays on your files and folders.

Screenshot of Finder integration on Mac with sync overlays for synced files

Notes: 

  • If you're an admin and want to enable sync icon overlays on multiple computers, you can use this Terminal command:

  • /usr/bin/pluginkit -e use -i com.microsoft.OneDrive-mac.FinderSync​​​​​​​

Users have two options when syncing files in SharePoint libraries and Teams. They can add shortcuts to libraries and folders to their OneDrive, or use the sync button on the library. 

Both options allow essentially the same thing—users can access files on their local computer in Finder. However, adding OneDrive shortcuts allows content to be accessed on all devices, whereas sync is related to a specific device. Additionally, OneDrive shortcuts offer improved performance versus using the sync button.

We recommend using OneDrive shortcuts as the more versatile option when available.

To sync libraries and folders using the sync button

  1. Click the Microsoft 365 app launcher The app launcher icon in Office 365, and then click SharePoint.

  2. Click the site that you want to sync.

  3. Click Documents or navigate to the subfolder that you want to sync.

  4. Click Sync.

    Screenshot showing Sync button on a SharePoint library.
  5. If your browser requests permission to use "Microsoft OneDrive," confirm that this is okay.

    Note: Your organization needs to enable SharePoint site syncing with the sync app for you to sync sites on your Mac. If you're the IT admin for your organization, see Enable users to sync SharePoint files with the new OneDrive sync app. If you're not the IT admin, contact your IT department.

  6. Choose the folders that you want to sync, and then click Start sync.

SharePoint team sites sync under a folder with your tenant name. This folder is automatically added to the left navigation pane in Finder.

Manage your syncing sites   

You can manage your syncing sites in the sync app settings.

  1. Click the OneDrive icon in the menu bar.

  2. Click Preferences, and then click the Account tab.

    Screenshot of the Account tab on the OneDrive sync client for the Mac
  3. To change the folders that you're syncing, click Choose Folders for that location, and then choose the folders that you want to sync. To stop syncing a site, click Stop Sync next to the site. (Copies of the files remain on your computer. You can delete them if you want.)

For additional resources about the sync app:

Title

Description

Deploy and configure the new OneDrive sync app for Mac

Learn how administrators can deploy the sync app on OS X to users in their enterprise environment.

OneDrive release notes

Release notes about the sync app.

Invalid file names and file types in OneDrive, OneDrive for Business, and SharePoint

Knowledge base article covering limits and restrictions (such as invalid characters in file names).

Need more help?

Back up your folders with OneDrive

Fix OneDrive sync problems on Mac

Why do I have two versions of OneDrive on my Mac?

Contact support icon

Contact Support For help with your Microsoft account and subscriptions, visit Account & Billing Help.

For technical support, go to Contact Microsoft Support, enter your problem and select Get Help. If you still need help, select Contact Support to be routed to the best support option.

Work or school badge

Admins Admins should view Help for OneDrive Admins, the OneDrive Tech Community or contact Microsoft 365 for business support.

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.