Cloud sync hidden storage

OneDrive Files On-Demand on Mac: How to Free Up Space and Make Files Online-Only (Step-by-Step 2026)

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:

  1. 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).
  2. Click the gear icon (Settings) in the top-right of the OneDrive popover.
  3. Select Preferences from the dropdown.
  4. Go to the Preferences tab (not Account or Backup).
  5. Look for Files On-Demand. Make sure the checkbox or toggle next to "Save space and download files as you use them" is enabled.
  6. 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

  1. Open Finder and navigate to your OneDrive folder (usually ~/OneDrive or visible in the sidebar under Locations).
  2. Right-click (or Control-click) any file that has a green checkmark indicating it's downloaded locally.
  3. 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

  1. Right-click a folder inside your OneDrive directory.
  2. 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

  1. Click the Apple menu and choose System Settings (macOS Ventura and later).
  2. Go to General, then Storage.
  3. 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.

Reclaim your disk in one click

Crumb audits your whole Mac, tells you what's safe to delete, and frees the space in seconds — private, local, and Apple-notarized.

Download Crumb for macOS

Frequently asked questions

Why is OneDrive still taking up space on my Mac even after I enabled Files On-Demand?
Enabling Files On-Demand prevents new files from downloading automatically, but it does not evict files that are already stored locally. You need to right-click each file or folder and select Free Up Space to remove the local copies. After doing this, the files remain accessible from the cloud but no longer consume local storage.
Will I lose my files if I select Free Up Space on OneDrive?
No. Free Up Space removes the local copy only. The file continues to exist in your OneDrive cloud account and will download again automatically the next time you open it. This is different from deleting, which would remove the file from OneDrive entirely.
How do I stop OneDrive from downloading everything to my Mac by default?
Open OneDrive Preferences from the menu bar icon, go to the Preferences tab, and confirm that Files On-Demand is enabled. Then in the Account or Sync tab, check whether any folders are set to always be available offline and uncheck the ones you do not need locally. With Files On-Demand on, only files you actually open will download.
Where is the OneDrive folder stored on macOS Sonoma, Sequoia, and Tahoe?
Depending on your OneDrive version and macOS, the folder is at either ~/OneDrive or ~/Library/CloudStorage/OneDrive-Personal. Newer versions of the OneDrive app use the native macOS Files Provider framework and appear under ~/Library/CloudStorage. You can also find it listed in the Finder sidebar under Locations.
Why does macOS System Settings show confusing storage categories after I free up OneDrive space?
macOS groups cloud storage files under categories like Documents or Other depending on which sync framework the app uses, and the readout can take several minutes to refresh after files are evicted. For an accurate count, use Finder's Get Info on the OneDrive folder and compare Size versus Size on disk, or run du -sh ~/OneDrive in Terminal, which reflects the current on-disk usage immediately.