Notion Sync Stuck on ‘Syncing’: Common Causes

You open Notion and see the “Syncing” status at the top of the window, but it never finishes. Your notes, databases, or pages remain outdated or inaccessible. This problem usually happens when the local client cannot communicate properly with the Notion servers due to network restrictions, corrupted cache files, or conflicting third-party software. This article explains the most common technical causes of a stuck sync in Notion and provides targeted fixes for each scenario.

Why Notion Sync Gets Stuck on “Syncing”

Notion uses a persistent WebSocket connection to keep your local data in sync with the cloud. When this connection drops or fails to establish, the client displays the “Syncing” status indefinitely. The root cause is almost always one of the following:

Network restrictions: Corporate firewalls, VPNs, or proxy servers often block WebSocket traffic on port 443 or interfere with Notion’s domain notion.com and all subdomains. If the initial handshake fails, the client retries but never completes.

Corrupted local cache: Notion stores a local copy of your workspace data in the system’s AppData folder. If this cache becomes corrupted due to an unexpected shutdown, disk error, or incomplete update, the client cannot reconcile local and server data, causing the sync to stall.

Antivirus or security software interference: Real-time scanning of Notion’s database files can lock them while the sync engine tries to write changes. This creates a deadlock where the client waits for file access that never comes.

Outdated Notion client: Older versions of the desktop app may use deprecated API endpoints or have known sync bugs that were fixed in later releases. The server may reject connections from an outdated client.

Steps to Diagnose and Fix a Stuck Sync

Follow these steps in order. Test the sync status after each step by checking the top bar or pressing Ctrl+R to force a refresh.

Step 1: Check Notion Server Status

Before troubleshooting your local setup, verify that the Notion servers are operational. Go to status.notion.com in a web browser. If the status page shows a major outage or degraded performance, wait for Notion to resolve the issue. No local fix will work during a server outage.

1. Open Notion status page
   Type status.notion.com in your browser address bar and press Enter.
2. Check the current status
   Look for any red or yellow indicators next to “API” and “Web App.” A green indicator means servers are operational.
3. If servers are down
   Wait 30 minutes and refresh the page. Notion typically resolves server issues within an hour.

Step 2: Clear the Notion Local Cache

A corrupted cache is the most common cause of a stuck sync. Clearing it forces the client to download a fresh copy of your workspace data.

1. Close Notion completely
   Right-click the Notion icon in the system tray and select Quit. Alternatively, press Alt+F4 on the main window.
2. Open the cache folder
   Press Windows+R, type %appdata%\Notion, and press Enter. This opens the Notion data folder.
3. Delete the Cache folder
   Locate the folder named Cache. Select it and press Shift+Delete to permanently remove it. Do not delete any other folders or files.
4. Restart Notion
   Open the Notion desktop app. You will see a brief “Syncing” message as it downloads fresh data. This should complete within a few seconds.

Step 3: Disable Proxy or Configure Manual Proxy

If you use a corporate or VPN proxy, Notion may not detect it automatically. Configure the proxy manually in Notion’s settings.

1. Open Notion settings
   Click your avatar in the top-right corner and select Settings & Members.
2. Go to My Network
   In the left sidebar, click My Network.
3. Configure proxy
   Under Proxy, select Manual. Enter the proxy server address and port provided by your network administrator. If you do not use a proxy, select No proxy.
4. Save and restart
   Click Save, then close and reopen Notion.

Step 4: Allow Notion Through Windows Firewall

Windows Defender Firewall may block Notion’s network access after a system update. Verify that both Notion.exe and Notion Update.exe are allowed.

1. Open Windows Security
   Press Windows+I to open Settings. Click Privacy & Security, then Windows Security, and select Firewall & network protection.
2. Allow an app through firewall
   Click Allow an app through firewall. If prompted by User Account Control, click Yes.
3. Check Notion entries
   Scroll down to find Notion and Notion Update. Ensure both have checkmarks in the Private and Public columns. If missing, click Change settings, then Add an app, browse to C:\Users\[YourUsername]\AppData\Local\Programs\Notion\Notion.exe, and add it.
4. Apply changes
   Click OK and restart Notion.

Step 5: Update Notion to the Latest Version

Running an outdated client can cause sync failures. Update Notion manually if the auto-update is stuck.

1. Check current version
   In Notion, click your avatar and go to Settings & Members. Under About, note the version number.
2. Download the latest version
   Go to www.notion.com/desktop and download the Windows installer.
3. Install the update
   Close Notion, run the installer, and follow the on-screen instructions. The installer replaces the old version and preserves your local settings.

If Notion Still Shows “Syncing” After the Main Fix

Antivirus software blocks Notion’s database files

Some antivirus programs, especially Bitdefender and McAfee, lock files in the AppData folder during real-time scanning. Temporarily disable real-time protection for one minute to test. If sync completes, add an exclusion for the folder %appdata%\Notion in your antivirus settings. Do not keep real-time protection disabled permanently.

VPN split-tunnel or DNS issues

If you use a VPN, the VPN may route Notion traffic through a slow or blocked server. Configure split-tunneling to exclude Notion from the VPN. Alternatively, flush your DNS cache: open Command Prompt as administrator, type ipconfig /flushdns, and press Enter. Restart Notion after flushing DNS.

Multiple Notion instances running

If you have both the desktop app and a browser tab open to the same workspace, they may conflict. Close all browser tabs that have Notion open. In Task Manager, end any Notion processes that are not responding. Then reopen only the desktop app.

Notion Sync Stuck: Desktop App vs Web App vs Mobile App

Item	Desktop App (Windows)	Web App (Browser)	Mobile App (iOS / Android)
Sync mechanism	Persistent WebSocket + local cache	WebSocket via browser	Background sync with local database
Common stuck cause	Corrupted cache, firewall block	Browser cache, extension interference	Low storage, outdated app version
Cache location	%appdata%\Notion\Cache	Browser’s local storage	App sandbox (non-accessible)
Proxy configuration	Manual in app settings	Uses system proxy	Uses system proxy
Offline access	Full offline cache	Limited to recent pages	Limited to pinned pages

You can now identify why your Notion sync is stuck and apply the correct fix based on the symptom. Start by clearing the local cache, then check your network configuration. For persistent issues, update the client and verify firewall rules. As an advanced step, use the Notion debug menu by pressing Ctrl+Shift+I and checking the Console tab for WebSocket error messages — this can reveal the exact domain or port being blocked.