If you repeatedly see an "Unsynced Changes" message in the Heptabase desktop app even when you're not editing notes, this troubleshooting guide can help identify the cause and fix the issue.
Possible causes
Local data conflict: Your desktop app's local database may have outdated or corrupted data, causing sync errors.
Unstable network connection: Issues like unstable internet, VPN use, or firewall settings can interrupt synchronization.
Large files blocking synchronization: Recently uploading large files, extensive text cards, massive tables, or bulk imports from apps like Obsidian, Notion, or Readwise might stall the syncing process.
How to Fix the Issue
Try the Web App
Go to the Heptabase web app and log in.
Check if the sync issue also occurs on the web version:
If the web app syncs correctly, your online data is safe. Temporarily use the web version while resolving the desktop issue.
If the web app also shows sync errors, the problem may involve network issues or something else entirely.
Contact Support
In either case, please reach out to our support team. Include details about your current issue, the specific error messages you've seen, and what you suspect might be the cause. Our team will promptly investigate and help you resolve the issue.