SharePoint Slow Uploads
Resolution Checklist
- 1 Configure upload throughput and bandwidth settings
- 2 Disable Office integration settings causing metadata sync blocks
- 3 Clear the Office Document Cache (ODC)
- 4 Adjust MTU and network settings for OneDrive client
- 5 Reduce the local OneDrive file synchronization scope
SharePoint Slow Uploads
This article provides a diagnostic checklist and troubleshooting guide to resolve SharePoint Slow Uploads (such as upload speeds stalling, OneDrive syncing taking hours for small files, or network throttling blocking uploads).
Root Causes / Meaning
Slow uploads in SharePoint and OneDrive are typically caused by:
- Bandwidth Throttling: The OneDrive sync client settings are configured to limit upload speed, or your network administrator enforces Quality of Service (QoS) throttling.
- Office Collaboration (File Lock) Integration: The OneDrive client syncs Office documents via the Office Integration API, which performs metadata checks and page-by-page validations rather than raw block-level uploads.
- Huge Document Library Scope: Syncing a single library with more than 100,000 files causes database locking and extreme metadata comparison overhead.
- Office Document Cache (ODC) Bloat: Corrupted and oversized cached data blocks inside the ODC delay write actions.
- Local Anti-Virus Interference: Real-time scanning tools inspect files during lock-write operations by OneDrive, compounding upload delays.
Initial Checklist
Before proceeding to advanced fixes, perform these basic checks:
- Run a Speed Test: Verify that your internet connection’s upload speed is not the primary bottleneck.
- Close Unused Browser Tabs: Active SharePoint web edits can hold locks on files, slowing down client sync.
- Verify File Sizes: Confirm if the slow upload is isolated to large files (e.g., video files) or affects all files.
Platform-Specific Resolving Steps
Windows Users
Step 1: Disable OneDrive Bandwidth Limits
- Right-click the OneDrive cloud icon in the taskbar and select Settings (gear icon) > Settings.
- Go to the Sync and backup tab and select Advanced settings.
- Under Limit download rate and Limit upload rate, set them to Don’t limit.
Step 2: Disable Office Integration Syncing
If Word/Excel files upload slowly, disabling the Office Collaboration feature allows OneDrive to handle files as standard binaries:
- Open OneDrive settings.
- Under the Sync and backup tab, expand Advanced settings.
- Toggle off File collaboration (or “Use Office applications to sync Office files that I open”).
Step 3: Command-Line Tweak for Network Adapter Autotuning
Optimize Windows network socket performance for cloud uploads:
:: Enable Window Auto-Tuning for TCP connections (requires Administrator privileges)
netsh interface tcp set global autotuninglevel=normal
macOS Users
Step 1: Force Disable Upload Throttling in OneDrive Plist
You can enforce unthrottled performance directly via defaults in the terminal:
# Configure OneDrive macOS preferences to eliminate speed caps
defaults write com.microsoft.OneDrive-mac UploadBandwidthLimit -int 0
defaults write com.microsoft.OneDrive-mac DownloadBandwidthLimit -int 0
# Apply changes by restarting the OneDrive client
killall OneDrive
open -a OneDrive
Step 2: Clear Office Cached Upload Tokens
# Terminate Microsoft Upload Center equivalent daemons
killall MSOSYNC 2>/dev/null
# Clean cached temp data where uploads are buffered
rm -rf ~/Library/Containers/com.microsoft.SharePoint-mac/Data/Library/Caches/*
Actionable Command Blocks
Measure Upload Speed to SharePoint Endpoints (macOS & Windows PowerShell)
Use these command blocks to verify that network connectivity to your SharePoint tenant is unhindered:
PowerShell (Windows): Test HTTP Connection Performance
# Measure round-trip time and packet size handling for SharePoint
$TenantUrl = "https://yourtenant.sharepoint.com"
Test-NetConnection -ComputerName "yourtenant.sharepoint.com" -Port 443
Curl (macOS): Test Network Latency
# Measure latency and response time to the tenant front door
curl -o /dev/null -w "Connect Time: %{time_connect}s\nTotal Time: %{time_total}s\n" \
-I "https://yourtenant.sharepoint.com"
Summary Checklist
- Ensured that OneDrive client bandwidth settings are set to Don’t limit.
- Disabled File Collaboration (Office Integration) in OneDrive’s advanced settings.
- Cleared the Office Document Cache (ODC) of temporary database files.
- Verified that the site or library is within the recommended 100,000 file limit.
- Whitelisted SharePoint and OneDrive network traffic in local firewalls and anti-virus software.