Add OneDrive to the Mac Finder sidebar and stop hunting for it

A OneDrive folder that syncs perfectly well can still be tedious to reach. The Finder sidebar arrives with Applications, Documents, Downloads and iCloud Drive already listed, and the folder holding the actual work sits somewhere else, behind a path nobody memorised. Every Open dialog starts in the wrong place. Every save turns into navigation.

The fix is small, and the reason it is not obvious is worth understanding, because the same reason explains why the entry sometimes disappears a week later, why two Macs with the same account show different things, and why dragging a file out of that folder behaves differently from dragging a file out of any other folder.

What the Finder sidebar is actually made of

Apple's documentation for the sidebar states the mechanism plainly: sidebar items are aliases to a folder, disk, or file, and if you add or remove a sidebar item, the original folder, disk, or file is not moved from its original location. Nothing is copied, nothing is relocated, and removing an entry deletes nothing.

That makes the sidebar cheap to experiment with. It also makes it fragile in one specific way, which comes up later.

The sidebar is divided into sections, and the sections behave differently. Favorites is the section you control by dragging. The list of built-in items that can appear there is governed by Finder settings: choose Finder, then Settings, then click Sidebar, then select or deselect items. Locations holds disks, network shares, and entries published by cloud storage apps through the system's file provider mechanism. Tags is driven by the Tags pane of the same settings window.

One line in Apple's description of that settings pane is the part most people miss. The items shown in the sidebar, it notes, also appear in Open and Save dialogs. This is the real reward for spending two minutes on the sidebar. The point is not that a Finder window looks tidier. The point is that every app on the Mac that presents a file picker now offers the OneDrive folder as a one-click destination.

Add the OneDrive folder to Favorites

The whole procedure is a drag, with one condition attached.

Open a Finder window and navigate to the OneDrive folder. Drag the folder onto the Favorites section of the sidebar. A gap opens between existing entries to show where it will land, and releasing the mouse creates the alias.

If there is no Favorites section to drop onto, that is the condition. Apple's instructions cover it directly: if you do not see the Favorites section, choose Finder, then Settings, click Sidebar, then select at least one item in the Favorites section. A Favorites section with every checkbox cleared is hidden entirely, and a hidden section cannot accept a drop.

Three variations are worth knowing.

A single file, rather than a folder, needs the Command key held down while dragging. The same applies to an app. Plain dragging a file to the sidebar does nothing useful.

Order is free. Drag any entry up or down and it stays where it is put.

Removal is the reverse gesture. Drag the icon out of the sidebar until the remove badge appears, and the entry goes. Apple restates the reassurance at this step: the link to the item in the sidebar disappears, but the folder, disk, or file remains in its original location.

There is also a per-section collapse. Hovering the pointer over a section heading reveals a control that hides or shows everything under it, which is useful when a long Favorites list has pushed Locations off the bottom of a laptop screen.

Where the OneDrive folder is, and why that is not a fixed answer

Unlike iCloud Drive, OneDrive does not have one canonical location on every Mac. Microsoft's setup documentation describes a screen titled "This is your OneDrive folder" with a Change Location button, and it advises choosing then, calling it the best time to make this change. Whatever was accepted at that moment is where the folder lives.

Managed Macs add another layer. Microsoft's deployment guidance for the Mac sync app documents a DefaultFolderLocation setting whose parameters are TenantID and DefaultFolderPath, which specifies the default location of the OneDrive folder for each organization. On a work Mac the folder may therefore sit wherever the administrator decided, and not where the local documentation examples suggest.

Account structure affects the naming. Microsoft documents that personal files appear under a OneDrive entry marked Personal and that work or school files appear under a OneDrive entry carrying the company name, and that a Mac can hold multiple work or school accounts but only one personal OneDrive account. The same documentation records a limitation that catches consultants and contractors: the macOS sync app does not currently support adding two business accounts from different organizations if they share the same display name, and attempting to configure such accounts results in a setup failure.

There is also more than one app. Microsoft's Mac deployment documentation distinguishes a standalone sync app from a Mac App Store edition, notes that the configuration keys are the same for both but the property list file name and domain name differ, and states that the standalone sync app is necessary for deploying and configuring Folder Backup settings, which the Mac App Store edition does not currently support. Two installs on one Mac can therefore produce two folders and two sidebar candidates.

Which subfolders are present is a separate decision made during the same setup. Microsoft describes a "Sync Files from Your OneDrive" screen for choosing the folders to bring down, and the stated reason is practical rather than cosmetic: it conserves space on the computer and reduces the bandwidth needed for the sync process. A folder excluded there will not exist locally at all, which is a different situation from a folder that exists and is online-only, and worth ruling out before assuming the sidebar entry is broken.

The practical consequence for a shortcut is simple. Find the folder once, deliberately, and note the path before dragging anything. Opening the sync app's menu and choosing the option to open the OneDrive folder is the reliable way to land in the right place, because it uses whatever location the app is actually configured with rather than the location the documentation assumes.

Three ways to keep it one click away, compared

Each of the options below works. They differ in how much they survive.

Approach	Also appears in Open and Save dialogs	Survives moving the folder	Setup cost
Alias in the Favorites section	Yes	No, the alias breaks	One drag
Built-in item enabled in Finder Settings	Yes	Not applicable, the target is fixed	One checkbox
Folder kept in the Dock	No	No	One drag
Places list in a file manager with a built-in terminal	Depends on the app	Depends on the app	Install and configure

The Favorites alias is the right default for one person on one Mac. The Dock is worth considering only when the goal is opening the folder rather than saving into it, because Dock entries do not populate file pickers.

The last row is the option that scales differently. A dedicated file manager keeps its own list of locations, usually alongside a shell and a preview pane, so switching between a synced folder and a project folder does not mean rebuilding the sidebar. That is a larger change than a drag, and it is worth reading what such a tool does differently before deciding it is warranted.

Why the entry disappears, and how to tell which cause applies

Four failures produce the same symptom, and they have different fixes.

The folder moved or was renamed. Because the sidebar entry is an alias, the target has to still be there. Changing the OneDrive folder location after adding the shortcut breaks it. Re-drag the folder.

Every Favorites checkbox got cleared. Deselecting the last built-in item in Finder Settings hides the whole section, taking custom entries out of view with it. Re-enable one item and the section reappears.

The Locations entry is not yours to drag. Cloud storage apps that use the system file provider mechanism publish their own sidebar entry under Locations. That entry belongs to the app, not to a folder you chose, and it comes and goes with the app's state rather than with your dragging.

A second install is pointing somewhere else. Where both the standalone and the Mac App Store sync apps have been installed, the folder that opens may not be the one the shortcut targets.

While troubleshooting, the Finder overlay badges are worth turning on if they are off, since they are the fastest read on sync state. Microsoft's instructions route through the system's Extensions settings, where OneDrive Finder Integration is toggled on.

A shortcut says nothing about whether the file is really there

This is the part a sidebar entry cannot help with, and it matters before a flight or a client visit.

With Files On-Demand, a file in the OneDrive folder is in one of three states, and Microsoft documents each one together with the file attribute state behind it.

State	File attribute	What is on the disk
Always available	Pinned	Full contents, kept
Locally available	Clearpin	Full contents, reclaimable
Online-only	Unpinned	Metadata only

Microsoft publishes scriptable commands for reading and setting these, run against the sync app binary inside the OneDrive application bundle. The query form is /getpin followed by a path; /pin, /clearpin and /unpin set the three states, and adding /r applies the change to everything inside a folder. Two constraints come with them: the sync app must be quit before the commands are run, and an online-only item cannot be set straight to locally available, because it has to pass through always available first.

Administrators have a further control, HydrationDisallowedApps, which prevents named apps from automatically downloading online-only files. It exists because some apps walk a whole folder tree and would otherwise pull down every byte. On a managed Mac, a folder that refuses to fill up for one particular app is not necessarily broken.

None of this shows in the sidebar. A Favorites entry gets you to the folder in one click and tells you nothing about whether its contents will open on a plane. Those are separate problems, and treating them as one is why "it was in the sidebar" and "it was downloaded" get confused.

What to change first

Enable one Favorites item in Finder Settings if the section is hidden, then drag the OneDrive folder into it, and confirm the entry now shows up inside a save dialog rather than only in Finder windows. That single check is what turns the shortcut from cosmetic into useful.

If the same folder is going to be opened dozens of times a day next to a terminal and a set of project directories, the sidebar stops being the right tool and a file manager with its own places list starts being one. The feature comparison is the place to judge whether Atriens is the kind of change that pays for itself.