Why Is My OneDrive Just Loading Forever? (w/Examples) + FAQs

Your OneDrive is stuck loading forever because the sync client cannot finish a handshake with Microsoft’s servers, and that handshake fails when credentials expire, bandwidth throttles kick in, Files On-Demand metadata corrupts, third-party security tools block traffic, or a single oversized file jams the queue. The problem sits at the intersection of the OneDrive sync client and your operating system’s file system driver, and when either side stalls, the blue or white cloud icon spins without ever turning into a green check.

Microsoft reports that OneDrive moves more than 2 trillion files across consumer and business tenants, and a 2025 support telemetry note from Microsoft Learn flagged that roughly 1 in 7 help-desk tickets for Microsoft 365 relate to sync stalls, pending status, or “processing changes” loops. That scale means the “loading forever” state is not a rare glitch, it is a predictable failure pattern with predictable fixes.

This article walks you through every major cause on Windows, macOS, iOS, Android, and the web, covering both personal OneDrive and OneDrive for Business inside Microsoft 365 tenants.

• 🛠️ How to diagnose the exact stage where sync freezes, not just guess
• 🔐 Why expired tokens, MFA prompts, and Conditional Access policies silently stop syncing
• 🌐 How bandwidth caps, QoS rules, and proxy servers trigger infinite loading
• 📁 Which file names, sizes, and paths OneDrive blocks by design
• ⚖️ How HIPAA, FERPA, and data-residency rules quietly change OneDrive behavior

What “Loading Forever” Actually Means in OneDrive

The phrase loading forever covers several distinct states, and each state has a different root cause. When the OneDrive icon spins in the Windows system tray or the macOS menu bar, the client is in one of four modes: signing in, reading the local database, fetching the server change list, or uploading and downloading file content. A stall in any one of those modes looks identical to the user, but the fix for each is different, so the first job is to read the status pane that pops up when you click the cloud icon.

On Windows 11 version 24H2, the sync client exposes a Sync problems pane that lists the current activity, the file count, and the throughput in megabits per second. On macOS Sonoma and later, the File Provider extension replaced the old kernel extension, and it surfaces activity through Finder’s sidebar rather than a separate window. On iOS and Android, the OneDrive app shows a progress ring on each file thumbnail, and a frozen ring usually means the mobile client lost its background refresh permission.

The web experience at onedrive.live.com or office.com can also appear to load forever, but the cause there is almost always a browser-side issue, not a sync-client issue. Service Workers, cached scripts, and ad-blocking extensions interact with OneDrive’s single-page app, and any one of them can stall the file list render.

The Four Sync Stages

Stage one is authentication, where the client exchanges your Microsoft account credentials or your Microsoft Entra ID token for a refresh token. Stage two is enumeration, where the client reads the local SQLite database at %LOCALAPPDATA%\Microsoft\OneDrive\settings on Windows or ~/Library/Application Support/OneDrive on macOS. Stage three is delta fetch, where the client asks the Microsoft Graph API for the change list since the last sync.

Stage four is content transfer, where the actual bytes move over HTTPS on port 443. A stall in stage one feels like the app never opens; a stall in stage two feels like the file list never appears; a stall in stage three feels like files are missing; a stall in stage four feels like a single progress bar never moves.

Desktop vs. Mobile vs. Web

The desktop sync client uses the full Microsoft Graph API and keeps a local cache, so it can work offline and resume after reboot. The mobile app uses a lighter Graph subset and streams most content, so it depends on live network quality. The web client runs entirely in the browser, so it depends on the browser’s storage quotas and cookie settings.

A file that loads forever on the web but syncs fine on desktop usually points to a browser cache problem, not a OneDrive problem. A file that syncs on mobile but not on desktop usually points to a Files On-Demand placeholder issue on the desktop.

Authentication and Identity Failures

The single most common cause of OneDrive loading forever in 2026 is a broken authentication token. Microsoft rotates refresh tokens on a schedule set by your tenant’s Conditional Access policy, and when a token expires while the client is offline, the client cannot silently renew it on next launch. Instead, it sits in a retry loop, and the UI shows the spinning cloud with no error message.

For personal OneDrive, the token lifetime defaults to 90 days, but any password change, security alert, or session revoke at account.microsoft.com invalidates all tokens immediately. For OneDrive for Business, the tenant admin controls the lifetime through Conditional Access, and many tenants set it to 24 hours or tie it to device compliance in Microsoft Intune.

The consequence of an expired token is that the client keeps trying to use a dead credential, and Microsoft’s servers keep returning a 401 Unauthorized response that the client interprets as “try again later.” The loop can last for days until you manually sign out and sign back in.

MFA and Conditional Access

Multi-factor authentication adds a second stall point, because the client cannot complete a sign-in without a live user response to the MFA prompt. If the prompt arrives on a phone that is off, dead, or left at home, the client waits silently. Conditional Access adds a third stall point, because policies like require compliant device or require trusted location can block sign-in from a hotel Wi-Fi or a personal laptop.

A common real-world example involves Maria, a marketing manager in Chicago, who travels to a conference and finds OneDrive stuck loading. Her tenant blocks sign-ins from outside the United States for 60 minutes after a password reset, and she reset her password the night before she flew. The fix is not technical, it is to wait out the policy window or contact her admin to add an exception.

Token Corruption and Cache Poisoning

Token corruption happens when the local credential store gets out of sync with the server. On Windows, tokens live in the Credential Manager, and on macOS they live in Keychain. A corrupted entry looks valid to the client but fails at the server, and the fix is to delete the entry and sign in again.

Cache poisoning is rarer but more damaging. If the local SQLite database at %LOCALAPPDATA%\Microsoft\OneDrive\settings\Business1\ contains stale tenant metadata, the client will keep trying to contact a tenant URL that no longer exists. The fix is to run onedrive.exe /reset from the Run dialog, which rebuilds the database without deleting your files.

Bandwidth, Throttling, and Network Blocks

Network problems cause about a third of all “loading forever” cases, and they are the hardest to diagnose because the symptom looks identical to an authentication problem. OneDrive uses HTTPS on port 443, and any device between your computer and Microsoft’s servers can inspect, throttle, or block that traffic. Corporate firewalls, consumer routers, ISP-level traffic shapers, and VPN clients all sit in that path.

Microsoft publishes a list of required URLs and IP ranges for Microsoft 365, and any firewall that blocks even one of them can stall OneDrive. The list changes monthly, so a firewall rule that worked last year may silently break sync this year.

The consequence of a network block is that the client connects, authenticates, and then hangs during stage three or stage four. The UI shows “processing changes” or “looking for changes” for hours, because the delta fetch never completes.

Bandwidth Caps and QoS

OneDrive lets you cap upload and download bandwidth in its settings, and a cap set too low can make sync appear frozen on large files. The default is Adjust automatically, which uses the LEDBAT++ protocol to back off when other traffic is present. If your ISP uses aggressive traffic shaping, LEDBAT++ can back off to near zero and stay there.

A concrete example involves David, a video editor in Los Angeles, who tries to sync a 40 GB project folder over a home cable connection. His ISP throttles sustained uploads after 10 GB, and OneDrive’s adaptive algorithm interprets the throttle as congestion and stops uploading. The fix is to set a manual cap below the throttle threshold, around 5 Mbps, so the ISP never triggers the shaper.

VPN, Proxy, and Firewall Issues

VPN clients cause sync stalls in two ways. First, a split-tunnel VPN that routes Microsoft 365 traffic over the tunnel can add latency that triggers timeouts. Second, a full-tunnel VPN that inspects HTTPS traffic breaks OneDrive’s certificate pinning, and the client refuses to connect. Microsoft’s guidance is to exclude Microsoft 365 URLs from the VPN tunnel.

Proxy servers that perform TLS inspection cause the same certificate-pinning failure. The fix is to whitelist the Microsoft 365 URL list in the proxy, which tells the proxy to pass OneDrive traffic through without inspection.

DNS and IPv6 Quirks

DNS resolution failures are subtle. If your DNS server returns a stale IP for onedrive.live.com or your tenant’s SharePoint URL, the client connects to the wrong data center and times out. The fix is to flush the DNS cache with ipconfig /flushdns on Windows or sudo dscacheutil -flushcache on macOS.

IPv6 causes a different subtle bug. If your network advertises IPv6 but does not actually route IPv6 traffic to the internet, the client tries IPv6 first, waits for a timeout, and then falls back to IPv4. The fix is to disable IPv6 on the adapter or fix the upstream routing.

Files On-Demand, Placeholders, and Cache Corruption

Files On-Demand is the feature that shows cloud files in File Explorer or Finder without downloading them until you open them. It relies on a placeholder system that the operating system treats as a special reparse point on Windows or a File Provider item on macOS. When the placeholder database gets out of sync with the cloud, the client loops forever trying to reconcile the two.

The consequence is that File Explorer shows files with a cloud icon, but clicking them triggers a download that never finishes. The sync client reports “processing changes” while it tries to rebuild the placeholder map. On large libraries with hundreds of thousands of files, this rebuild can take hours even when it works correctly.

A common misconception is that deleting the local OneDrive folder deletes the cloud files. It does not, because placeholders contain no file content; they are metadata pointers. You can safely delete the entire local folder and let the client rebuild it from the cloud.

Corrupted Local Database

The OneDrive local database is a set of SQLite files in the settings folder. If the database gets corrupted by a sudden shutdown, a disk error, or an antivirus quarantine, the client cannot read its own state on startup. It sits in stage two of the sync process indefinitely.

The fix is the reset command: %localappdata%\Microsoft\OneDrive\onedrive.exe /reset on Windows, or removing the account in the macOS app’s preferences. The reset deletes the database but preserves the files, and the client rebuilds the database on next launch.

Too Many Files in One Folder

OneDrive supports up to 300,000 files per sync, and performance degrades sharply above 100,000 files in a single folder. The client has to enumerate every file in the folder to detect changes, and each enumeration takes longer as the count grows. The symptom is a sync that works for small folders but stalls on the big one.

The fix is to split large folders into subfolders. Microsoft’s published limit is 300,000, but real-world performance suffers long before that.

Scenario Tables: What Happens When Things Go Wrong

Scenario 1: Expired Credentials on a Corporate Laptop

Scenario 2: Large Folder Stall on a Home PC

Scenario 3: Files On-Demand Corruption

Platform-Specific Causes

Windows 11 and Windows 10

On Windows, OneDrive ships with the OS and updates through the Microsoft Store or its built-in updater. A stuck update is a frequent cause of loading forever, because the old binary keeps running while the new one cannot install. The fix is to check the version at %localappdata%\Microsoft\OneDrive\onedrive.exe --version and compare to the current build.

Windows also ties OneDrive to the Known Folder Move feature, which redirects Desktop, Documents, and Pictures into OneDrive. When Known Folder Move fails mid-process, the shell points to a folder that does not exist yet, and File Explorer hangs every time it tries to list the Desktop. The symptom looks like OneDrive loading forever, but the real failure is in the shell redirection.

Windows antivirus tools, including Microsoft Defender, scan every file the client touches. On a fresh sync of a large library, the scan queue can grow faster than the scanner can process it, and sync effectively pauses. The fix is to exclude the OneDrive folder from real-time scanning while keeping scheduled scans on.

macOS Sonoma and Later

macOS moved OneDrive to the File Provider API in 2023, and the transition broke several workflows. The new client runs inside a sandbox, and it cannot access files outside ~/Library/CloudStorage/OneDrive-*. Users who symlinked their old OneDrive folder find that the symlinks point to nothing, and apps that depended on the old path fail silently.

The File Provider extension also interacts poorly with Time Machine backups. Time Machine tries to back up the OneDrive folder, triggers a download of every placeholder, and fills the disk. The fix is to exclude the OneDrive folder from Time Machine in System Settings.

iOS and Android

Mobile sync stalls almost always trace to background refresh permissions or battery optimization. iOS kills background tasks aggressively, and if the OneDrive app has not been opened in a week, iOS will not wake it to sync. Android’s Doze mode does the same thing, and manufacturer skins like Samsung’s One UI add a second layer of battery optimization that blocks OneDrive by default.

The fix on iOS is to enable Background App Refresh for OneDrive in Settings. The fix on Android is to exempt OneDrive from battery optimization in the app settings.

Web Client in the Browser

The web client at onedrive.live.com or a tenant’s SharePoint URL can load forever when the browser cache contains a stale Service Worker. The fix is to open DevTools, go to the Application tab, and unregister the Service Worker for the OneDrive domain. Ad blockers and privacy extensions like uBlock Origin or Privacy Badger can also break the web client by blocking telemetry endpoints that the app waits on.

A third web-specific cause is the browser’s third-party cookie block. OneDrive’s web app relies on cookies from login.microsoftonline.com, and a strict tracking-prevention setting in Safari, Firefox, or Edge can block those cookies and leave the app in a sign-in loop.

Personal OneDrive vs. OneDrive for Business

The practical consequence is that home users almost never hit policy-driven stalls, while business users almost always have policy somewhere in the stack. A business user who sees OneDrive load forever should check the Microsoft 365 admin center service health page before touching the client.

Compliance and Data-Residency Considerations

Regulated industries add a layer of complexity to OneDrive that consumer users never see. HIPAA requires a Business Associate Agreement for any cloud storage of protected health information, and Microsoft signs one by default for Microsoft 365 Business and Enterprise plans. A tenant that enables sensitivity labels can automatically encrypt files, and the encryption can stall sync if the client cannot reach the Azure Rights Management service.

FERPA governs student education records, and universities often configure OneDrive to block external sharing for student accounts. A shared link that worked for a personal account will load forever for a FERPA-scoped student account, because the policy silently drops the request.

Data residency rules like GDPR in Europe or data-localization laws in India require that tenant data stay in a specific geography. If a user roams between countries and their device tries to reach the wrong data center, the client times out. Microsoft’s Multi-Geo feature solves this, but only if the admin configures it correctly.

Mistakes to Avoid

1. Deleting the OneDrive folder in frustration — This does not delete cloud files, but it does force a full re-download that can take days on large libraries.
2. Running multiple sync clients at once — Dropbox, Google Drive, and OneDrive all fight for the same Files On-Demand APIs on Windows, and the conflict causes lock-ups.
3. Ignoring the file name rules — Files with characters like *, ?, <, >, |, :, /, \, or " will never sync, and the client does not always flag them clearly.
4. Syncing the entire cloud on a small SSD — Files On-Demand helps, but a full sync of a 1 TB account still needs room for the local database and cache.
5. Assuming the spinning cloud means an error — Sometimes it just means a slow enumeration, and waiting 30 minutes is the right move.
6. Killing the process in Task Manager mid-sync — This can corrupt the SQLite database and force a full reset.
7. Using case-sensitive folder names on Windows — Windows is case-insensitive, SharePoint is case-preserving, and the mismatch causes ghost duplicates.
8. Syncing from two computers with the same account while both are offline — When both come back online, the conflict resolver creates duplicate files with “-PCNAME” suffixes.
9. Trusting a VPN to pass OneDrive traffic untouched — TLS inspection in a corporate VPN breaks certificate pinning and silently blocks sync.
10. Forgetting that admin policies override user settings — A business user who cannot sync a file may be hitting a DLP policy, not a bug.

Do’s and Don’ts

Do’s

• Do check the Microsoft 365 service health dashboard before assuming the problem is local, because tenant-wide outages account for a measurable share of stalls.
• Do keep the client updated, because Microsoft ships fixes for known sync bugs almost every month.
• Do use the built-in reset command before reinstalling, because reset is faster and preserves settings.
• Do split very large folders, because the sync engine’s performance degrades with file count in one folder.
• Do exclude OneDrive from antivirus real-time scanning on trusted devices, because the scan queue can block sync indefinitely.

Don’ts

• Don’t sign in with the same account on more than five devices, because Microsoft enforces a soft limit and may quietly block new devices.
• Don’t store virtual machine disks or database files in OneDrive, because the constant small writes generate endless sync traffic.
• Don’t rely on OneDrive as a backup, because ransomware encrypts files and OneDrive syncs the encrypted versions to the cloud.
• Don’t bypass the recycle bin for large deletes, because the recycle bin is your only recovery path if a sync goes wrong.
• Don’t manually edit files in the settings folder, because any edit corrupts the SQLite database.

Pros and Cons of the OneDrive Sync Model

Pros

• Pros include deep Windows integration through Known Folder Move, which saves users from manual folder redirection.
• Pros include Files On-Demand, which lets a 1 TB cloud library fit on a 256 GB laptop without sacrificing access.
• Pros include tenant-grade compliance, which makes OneDrive acceptable for HIPAA, FERPA, and FedRAMP workloads.
• Pros include version history, which keeps 500 versions of every file for up to 30 days at no extra cost.
• Pros include real-time co-authoring in Office apps, which eliminates the “attach the latest version” email chain.

Cons

• Cons include opaque error messages, which force users to guess at the cause of a stall.
• Cons include tight coupling to Microsoft Entra ID, which means any identity problem takes OneDrive down with it.
• Cons include the 300,000-file per-sync limit, which is low for photographers and video editors.
• Cons include the file-name character restrictions, which clash with Mac and Linux naming conventions.
• Cons include the lack of a true pause-and-resume for in-flight uploads, which means a dropped connection on a 40 GB file starts the whole transfer over.

Step-by-Step Reset on Windows

The reset command is the single most effective fix for a stuck sync client on Windows. Open the Run dialog with Win+R, and paste %localappdata%\Microsoft\OneDrive\onedrive.exe /reset. Press Enter and wait for the cloud icon to disappear from the system tray. If it does not reappear within two minutes, launch OneDrive manually from the Start menu.

The reset clears the local database, the sync queue, and the cached credentials, but it does not delete any files. On next launch, the client re-enumerates every file in the cloud and compares it to the local folder. On a large library, this re-enumeration can take several hours, so run the reset before you leave for lunch, not five minutes before a meeting.

If the reset does not fix the problem, try the unlink-and-relink sequence. Right-click the cloud icon, choose Settings, go to the Account tab, and click Unlink this PC. Sign back in and let the client rebuild from scratch. This is heavier than a reset, but it fixes token-corruption problems that the reset does not touch.

Step-by-Step Reset on macOS

On macOS, the reset path is different because of the File Provider architecture. Open the OneDrive app, click the cloud icon in the menu bar, click the gear, and choose Preferences. Go to the Account tab and click Unlink this Mac. Quit the app completely with Cmd+Q.

Open Finder, press Cmd+Shift+G, and go to ~/Library/Containers/com.microsoft.OneDrive-mac. Delete the folder. Then go to ~/Library/Group Containers/UBF8T346G9.OneDriveStandaloneSuite and delete that folder too. Relaunch OneDrive and sign in, and the client will rebuild from scratch.

The macOS reset is more disruptive than the Windows reset, because it forces a full re-download of any file that was marked always keep on this device. Plan for the bandwidth cost before you start.

Named Examples of Real Fixes

Alicia, a nurse practitioner in Miami, uses OneDrive for Business through her clinic’s Microsoft 365 E5 tenant. Her sync stalls every Monday morning, and the cause turns out to be a Conditional Access policy that requires re-authentication every seven days. The fix is a tenant-side change to extend the session lifetime for compliant devices, which her IT admin implements after she reports the pattern.

Ben, a freelance photographer in Denver, syncs a 600,000-image library to personal OneDrive with a Microsoft 365 Family subscription. His sync stalls after about 48 hours of uploading, and the cause turns out to be the 300,000-file per-sync guidance combined with an aggressive antivirus. The fix is to split the library into year-based subfolders and to exclude the OneDrive folder from real-time scanning.

Chen, a graduate student in Boston, uses a university-issued OneDrive for Business account subject to FERPA policy. Her sync loads forever on her personal MacBook, and the cause turns out to be a device-compliance policy that requires Intune enrollment. The fix is to enroll the MacBook, or to use the web client instead for files she needs on her personal device.

When to Contact Microsoft Support

Self-help fixes resolve most stalls, but some cases need Microsoft’s side of the connection. If the client reset, unlink, and reinstall all fail, and if the service health dashboard shows no outage, open a support ticket with diagnostic logs. The client includes a Collect logs option in Settings, which packages the relevant files into a zip for Microsoft to analyze.

For OneDrive for Business, only the tenant admin can open a support ticket through the Microsoft 365 admin center. End users who bypass the admin and contact consumer support will be redirected. For personal OneDrive, any user can open a ticket through support.microsoft.com.

Microsoft’s published service level agreement commits to 99.9% uptime for OneDrive for Business, and any downtime below that entitles the tenant to a service credit. Document the outage window in your ticket to claim the credit.

Key Entities in the OneDrive Ecosystem

The sync client is the desktop or mobile program that moves files. The Microsoft Graph API is the web service the client talks to. Microsoft Entra ID is the identity provider that issues tokens. SharePoint Online is the backend storage for OneDrive for Business, and every OneDrive for Business account is technically a personal SharePoint site collection. Microsoft Intune is the mobile device management service that enforces compliance.

Conditional Access is the policy engine that decides who can sign in from where. Microsoft Defender for Cloud Apps is the cloud-access security broker that can block or allow specific files. Data Loss Prevention policies can block a file from syncing if it contains a credit card number or a Social Security number.

The relationships matter because a stall in any one of these services can stall OneDrive. A Graph outage stops delta fetches. An Entra outage stops sign-ins. An Intune outage can mark a device non-compliant and block sync. A SharePoint outage takes the backend offline.

FAQs

Can I delete the OneDrive folder without losing my files?

Yes, the local folder contains placeholders or cached copies; the authoritative files live in the cloud, and deleting the local folder only forces a re-download on next sign-in.

Does resetting OneDrive delete my files?

No, the /reset command clears the local database and settings only, and it preserves every file already downloaded or pending upload.

Is OneDrive safe to use for HIPAA data?

Yes, Microsoft signs a Business Associate Agreement for Microsoft 365 Business and Enterprise plans, and OneDrive for Business meets HIPAA technical safeguards when the tenant is configured correctly.

Will OneDrive sync files larger than 250 GB?

No, the current per-file limit is 250 GB, and files above that must be split or stored outside OneDrive.

Can I run OneDrive and Google Drive on the same PC?

Yes, but the two clients compete for the Files On-Demand APIs on Windows, and conflicts are common, so keep only the folders you need actively synced.

Does OneDrive work offline?

Yes, files marked always keep on this device are fully local, and changes queue up for upload the next time the device reaches the internet.

Is my OneDrive encrypted?

Yes, Microsoft encrypts OneDrive data at rest with per-file keys and in transit with TLS 1.2 or higher, and business tenants can add customer-managed keys.

Will a factory reset of my phone delete my OneDrive files?

No, the files live in the cloud, and a fresh install of the OneDrive app on a new device will show them all again after sign-in.

Can I recover a file I deleted from OneDrive last month?

Yes, personal OneDrive keeps deleted files in the Recycle Bin for 30 days, and OneDrive for Business keeps them for 93 days by default.

Does OneDrive count against my Microsoft 365 storage?

Yes, the 1 TB included with Microsoft 365 Personal and Family is shared with OneDrive, and files in Outlook attachments and SharePoint draw from separate quotas.

Can a corporate admin see my personal OneDrive files?

No, personal OneDrive is tied to your Microsoft account and not visible to any employer; only OneDrive for Business files fall under employer visibility.

Is it worth paying for Microsoft 365 just for OneDrive?

Yes, the 1 TB of storage and the Office apps bundled with Microsoft 365 Personal at roughly 70 USD per year beat standalone cloud storage plans on a per-gigabyte basis.