What you will achieve

Fix iCloud Drive, Photos, and service sync when Mac stops uploading or shows stuck items.

iCloud sync stalls from full disks, Apple ID issues, corrupt bird daemon state, or filenames incompatible across platforms. Sign out/in is heavy-handed but fixes many stuck queues. Check storage plan before blaming Apple servers.

1) Check status

Apple System Status page for iCloud outages.
System Settings → Apple ID → iCloud — no payment or storage full banner.
Finder → iCloud Drive — cloud icons stuck on upload.

2) Sign out/in iCloud

Sign out of iCloud on Mac — choose keep copy of data when prompted. Sign back in. Last resort for corrupt sync state; can duplicate conflicts — backup first.

3) brctl and bird (advanced)

brctl log --wait --shorten
killall bird

Restart iCloud sync daemon; watch logs for stuck path. Exclude problematic huge files from Desktop sync temporarily.

4) Photos library

One Photos library per Apple ID; open primary library in Photos → Settings → iCloud → Download Originals vs Optimise. Library repair from Photos help menu if database corrupt.

5) Keychain and Drive compete

Low disk space blocks uploads — free 10+ GB. Date/time must be automatic in General → Date & Time.

6) Stuck “uploading” files

Finder dot on iCloud file — right-click → Download Now forces pull; upload stuck often filename with illegal chars for Windows sync partners. Remove colon from filename.

7) Optimise vs full

Low disk prevents upload queue drain — free 20 GB, restart bird daemon. Check ~/Library/Application Support/CloudDocs size in Activity Monitor disk tab indirectly via system data.

8) Multiple Apple IDs

Notes and Messages tied to Apple ID — signing into different ID on Mac vs iPhone splits sync universe. Pick one primary for personal data.

Verify

Files upload — cloud icon clears; iCloud.com shows new files; Photos counts match across devices overnight.

Additional troubleshooting notes

If steps above do not resolve the issue on the first attempt, reboot once, confirm System Settings → General → Software Update is current, and retry with a second administrator account to rule out profile or keychain corruption in your daily user. Document exact error text from Console.app with timestamp — vague “it still fails” without logs wastes support time. On Apple Silicon, re-test after full shutdown (not just restart) because firmware and Thunderbolt controllers reset only on cold boot. Intel Macs should repeat test in Safe Mode to bypass third-party login items. Before erase or keychain reset, verify Time Machine or clone backup completed — batch 3 guides assume Monterey/Ventura/Sonoma/Sequoia paths in System Settings; search Spotlight for renamed panes if your macOS version labels differ slightly.