Troubleshooting

Symptoms → likely causes → things to try.

Sign-in fails

• OAuth window opens but never returns to Obsidian — make sure Obsidian is set as the handler for the custom URL scheme. Try closing the OAuth tab and rerunning Engram: Sign in.
• “Invalid token” after sign-in — your session may have expired. Sign out (Engram: Sign out) and back in.

Sync is stuck “Pending push: N”

• Check the Sync Center → Recent activity log for the most recent error.
• If the backend is reachable but pushes 409 (version conflict), it’s likely a real conflict — open the Conflicts queue.
• If pushes return 413, the note is over the per-note size cap. Split it.
• If pushes return 429, you’re being rate-limited. Wait a minute and retry, or check your subscription tier.

Web app shows stale content

• Pull the page once (refresh). The web app subscribes to live updates but the initial load is cached.
• Confirm the plugin in Obsidian shows Last sync time later than your most recent edit.

A specific note won’t sync

• Check the path for illegal characters (especially on mobile, see Mobile).
• Check note size — there is a per-note size cap.
• Open the Sync Center, find the note in Pending push, hover for the error reason.

Plugin won’t load after update

• Open Obsidian’s developer console (Ctrl/Cmd+Shift+I) and check for errors mentioning engram-vault-sync.
• Try toggling the plugin off and on in Settings → Community plugins.
• If a release shipped broken, file the bug at engram-app/Engram-obsidian and uninstall the plugin temporarily — the previous version is not recoverable from inside Obsidian once the community-directory update installs.

Where to file bugs

engram-app/Engram-obsidian issues. Include:

• Obsidian version, platform (desktop/iOS/Android), and OS version
• Engram plugin version
• Screenshot of the Sync Center → Recent activity log
• Steps to reproduce