Skip to content

Common Issues

Quick solutions to frequently encountered problems.

Sync Problems

Notes Not Appearing on Other Devices

  1. Check your internet connection
  2. Open the Account HUD and verify you're signed in
  3. Pull down to refresh the note list
  4. Check that sync isn't paused in Settings

Changes Not Saving

  1. Ensure you're online (offline mode has limitations)
  2. Check if you've hit your storage limit in the Account HUD
  3. Try closing and reopening the note
  4. Refresh the browser or restart the app

:::info Notes show a small sync indicator when saving. If you see a spinning icon for more than 30 seconds, there may be a connection issue. :::

Storage and Limits

Storage Limit Reached

When you see an amber indicator in the Account HUD:

  1. Open the Account HUD (your avatar or storage display)
  2. Review which notes use the most space
  3. Archive notes you don't need active
  4. Consider upgrading to Pro for more storage

:::warning Your data is never deleted automatically. You control what gets archived. :::

Understanding Storage Display

  • Green: Under 80% capacity
  • Amber: 80-99% capacity (still functional, just means you may want to archive)
  • Red: Only shown for true errors, not for reaching documented limits

Login Issues

Can't Sign In

  1. Verify your email address is correct
  2. Check if you used social login (Google/GitHub) instead of password
  3. Try the "Forgot Password" flow
  4. Clear browser cache and cookies, then try again

Two-Factor Authentication Problems

  • Code not working: Check your device's time is accurate
  • Lost authenticator: Use a backup code
  • No backup codes: Contact support

Session Expiring

If you find yourself signed out frequently:

  1. Check that cookies aren't being cleared by your browser
  2. Ensure "Remember Me" is selected on sign in
  3. Check for browser extensions blocking cookies

Performance Issues

Slow Loading

  1. Close unused browser tabs
  2. Disable unused extensions
  3. Try the desktop app instead of browser
  4. Check your internet speed

High Memory Usage

  1. Limit the number of open notes
  2. Close browser tabs with Glassy open
  3. Restart the app periodically

Data Recovery

Accidentally Deleted a Note

  1. Check the Archive (Notes → Archived)
  2. Look in Trash (notes stay for 30 days)
  3. Contact support if the note isn't in either

How to Restore from Archive

  1. Go to your Notes list
  2. Find Archive in the sidebar
  3. Locate the note you want to restore
  4. Select it and choose Restore

Capture & Extension Issues

My capture didn't save

Use this decision tree to diagnose a missing capture:

  1. Is there a badge number on the extension icon?
  2. Yes → your capture is in the offline queue. Wait 60 seconds for an auto-flush, or check Settings → Debug → Offline Queue to see the error.

  3. No → proceed to step 2.

  4. Does the popup show a "Success" toast?

  5. Yes → the capture was accepted; search Glassy for the title or URL.

  6. No → check the browser console for CONTENT_SCRIPT_ERROR messages (right-click extension icon → Inspect background service worker).

  7. Is the page a PDF, browser-internal page (e.g. chrome://, about:), or a page with strict CSP?

  8. Yes → extractor.js cannot run on these. The capture will still proceed with URL and title, but the body will be empty. This is expected.

  9. Is the configured server URL correct?

  10. Open Settings → Server URL and verify it matches your Glassy instance (e.g. https://app.glassy.fyi).

  11. Still missing? Check server logs: 

    docker logs glassy-dash-prod | grep "POST /api/captures"
    A 500 here means the server accepted the request but encountered a DB error. Contact support with the log snippet.

Screenshot is broken or not embedded

Screenshots are uploaded as WebP to POST /api/ext/capture-image on your Glassy server. If the upload fails:

  • The capture text (title, URL, Markdown body) is still saved.
  • The screenshot embed will be absent from the capture.
  • The upload error is logged in the extension's service worker console.

Common causes and fixes:

Symptom Likely cause Fix
![Screenshot](broken-url) in capture Server was offline at capture time Re-capture when server is reachable
No screenshot section at all Smart capture wasn't expanded Tap ⚙ Smart capture to expand, then use the Screenshot button
Upload succeeds but image shows blank Browser screenshot permission denied Check activeTab and tabs permissions in chrome://extensions
Image URL points to wrong server Wrong server URL in Settings Update Settings → Server URL to your correct instance

Content script error badge

If the extension icon shows a small error indicator after a capture:

  1. Open the extension popup — the error message is shown inline.
  2. Common errors:
  3. "Cannot access page" — restricted URL (PDF, chrome:// pages, extension pages)
  4. "Readability parse failed" — the page had no detectable content body (login page, SPA loading state). Tags and URL are still captured.
  5. "Server unreachable" — capture is queued offline; see Offline Behavior.

Getting More Help

If these solutions don't resolve your issue:

  1. Search the FAQ for specific topics (coming soon — see docs.glassy.fyi)
  2. Check the System Status for outages
  3. Contact support through the Help Center