OneDrive is one of the most common culprits when your Mac's storage fills up unexpectedly. Even if you barely use the files, the default sync behavior downloads everything to your local drive, quietly consuming gigabytes of space. The good news: Microsoft built a feature called Files On-Demand that keeps your files in the cloud and only downloads them when you open them. This guide walks through exactly how to enable it, convert existing downloads back to online-only, and confirm how much space you actually got back.
Why OneDrive Takes Up So Much Space on Mac
When you install the OneDrive app on macOS and sign in, it mirrors your entire cloud storage to a local folder at ~/OneDrive (or ~/Library/CloudStorage/OneDrive-Personal on newer macOS versions with native integration). Every file you have stored in the cloud gets downloaded and kept on your drive. For users with hundreds of gigabytes in OneDrive, this can fill a MacBook SSD fast.
There are two distinct behaviors to understand:
- Fully downloaded: The file lives both in the cloud and on your Mac. Takes local space.
- Online-only (Files On-Demand): Only a lightweight placeholder exists locally. The file downloads automatically when you open it, then can be evicted again.
Files On-Demand is the setting that gives you control over which behavior applies, and it's not always turned on by default.
Step 1: Enable Files On-Demand in OneDrive Preferences
Before you can make files online-only, you need to confirm the feature is active. Here's how to check and enable it:
- Click the OneDrive cloud icon in your menu bar. If you don't see it, look in the overflow menu (the arrow at the right end of the menu bar).
- Click the gear icon (Settings) in the top-right of the OneDrive popover.
- Select Preferences from the dropdown.
- Go to the Preferences tab (not Account or Backup).
- Look for Files On-Demand. Make sure the checkbox or toggle next to "Save space and download files as you use them" is enabled.
- Click OK to save.
On macOS Sonoma, Sequoia, and Tahoe (2025/2026), OneDrive integrates with the native iCloud Drive / Files Provider framework, so Files On-Demand is typically on by default for fresh installs. If you upgraded from an older OneDrive version, double-check this setting.
Step 2: Make OneDrive Files Online-Only with Right-Click
Once Files On-Demand is enabled, you can convert any downloaded file or folder back to an online-only placeholder. This is the fastest way to onedrive free up space mac without deleting anything from the cloud.
Free up a single file
- Open Finder and navigate to your OneDrive folder (usually
~/OneDriveor visible in the sidebar under Locations). - Right-click (or Control-click) any file that has a green checkmark indicating it's downloaded locally.
- Select Free Up Space from the context menu.
The file icon will change to a cloud icon with a download arrow, confirming it is now stored online only. The local copy has been removed and the space is immediately reclaimed.
Free up an entire folder at once
- Right-click a folder inside your OneDrive directory.
- Select Free Up Space.
OneDrive will recursively convert every locally downloaded file inside that folder to online-only. For large folders with photos, videos, or project archives, this can reclaim tens of gigabytes instantly.
What the status icons mean
- Green circle with checkmark: Downloaded locally and up to date.
- Cloud with download arrow: Online-only, will download when opened.
- Blue sync arrows: Currently syncing or uploading.
- Red X: Sync error, needs attention.
Step 3: Use Terminal to Free Up Space in Bulk
If you want to convert your entire OneDrive folder to online-only in one command, Terminal gives you a faster path. The brctl command (the same tool macOS uses internally for iCloud Drive eviction) works with OneDrive when it uses the Files Provider framework.
However, for the standalone OneDrive app, the most reliable bulk method is the mdls and Finder integration. Here's a Terminal approach using the built-in xattr trick that forces eviction:
# Check how much space your OneDrive folder is using locally
du -sh ~/OneDrive
For a selective approach, you can also use Finder's Get Info (Command-I) on any file or folder to see the "Size on disk" versus the logical file size. A large gap means the files are fully downloaded.
The most reliable bulk method remains right-clicking the top-level OneDrive folder and selecting Free Up Space. This processes everything in one pass.
Step 4: Verify How Much Space You Reclaimed
After freeing up space, confirm the reclaim was successful before assuming you're done. macOS does not always update storage readings instantly.
Using About This Mac
- Click the Apple menu and choose System Settings (macOS Ventura and later).
- Go to General, then Storage.
- Wait for the bar to finish calculating. You should see the "Documents" or "iCloud Drive" category shrink if OneDrive uses the native Files Provider.
Note: macOS sometimes lumps OneDrive local data under "Other" or "Documents" depending on which OneDrive integration you're using. The category labels are not always precise.
Using Finder's Get Info
Right-click your OneDrive folder and choose Get Info. Compare Size (logical, cloud total) versus Size on disk (what's actually stored locally). After running Free Up Space, "Size on disk" should drop dramatically while "Size" stays the same, because the data still exists in the cloud.
Using Terminal
# Before: run this, note the number
du -sh ~/OneDrive
# After freeing up space: run again
du -sh ~/OneDrive
You should see the reported size shrink to just a few megabytes for the placeholder files, even if your OneDrive account holds hundreds of gigabytes.
Preventing OneDrive from Re-Downloading Files
Files On-Demand means files re-download automatically when you open them. This is the intended behavior, but it can feel like the space fills up again over time. A few habits help:
- Avoid opening large video or archive files unless you need them. They will download and stay local until you manually free up space again.
- You can repeat the right-click Free Up Space step whenever a folder accumulates local copies again.
- In OneDrive Preferences, check the Sync tab to see if any folders are set to always keep local copies ("Always available offline"). Uncheck folders you don't need offline.
What If "Free Up Space" Is Missing from the Right-Click Menu?
This option only appears when Files On-Demand is enabled and the file is currently downloaded. If you don't see it:
- Confirm Files On-Demand is turned on in OneDrive Preferences (Step 1 above).
- Quit and relaunch OneDrive from the menu bar icon.
- Make sure you are right-clicking a file inside the OneDrive folder, not a shortcut or alias elsewhere.
- If the file shows a cloud icon already, it is online-only and there is nothing to free up.
Checking What Is Still Stored Locally After Freeing Space
Even after a thorough Free Up Space pass, some files may stay local. OneDrive keeps recently opened files downloaded as a cache. If you want a precise picture of what OneDrive data is actually on your drive versus what is a placeholder, a disk-space tool can sort this out quickly.
Crumb's whole-disk map shows you exactly how much data sits in your OneDrive folder versus the rest of your drive. After you run Free Up Space, you can open Crumb, scan your disk, and confirm the OneDrive folder has shrunk to placeholder-only sizes. It runs entirely on-device and does not require an account, so your file names and paths never leave your Mac. It is a useful sanity check when macOS's own storage readout is slow to update or shows confusing category labels.
Between the built-in Files On-Demand controls in OneDrive and a clear picture of what's on disk, you have everything you need to keep OneDrive from quietly eating your storage.