Documentation
Troubleshooting

Troubleshooting

1) My changes didn't appear on another device

Cause: The other device hasn't synced yet.

Fix:

  • Bring the other tab into focus — this triggers a pull from the server.
  • Check the connection indicator (top-right of the board header):
    • Grey = offline
    • Blue / pulsing = syncing
    • Green = saved and synced
  • Ensure both devices are logged into the same account (if access control is enabled).

2) I imported a file but notes are missing

Cause: Some note blocks in the Markdown file are malformed.

Fix:

  • Review the import warnings in the preview dialog — partial import may skip malformed notes.
  • Confirm each note block has a --- delimiter line between the metadata and content body.
  • Confirm x: and y: values are numbers, and color: is a valid value (yellow, blue, green, pink, orange, purple).
  • See Import and Export for the canonical format.

3) AI won't run

Cause: Authentication issue, quota exceeded, or rate limit hit.

Fix:

  • Confirm you are logged in (the board header should show your email).
  • Check your plan quota: AI credits are limited per month. Go to Subscription page to see remaining credits.
  • If you recently ran many AI operations, wait a minute and retry (per-user rate limit applies).
  • If the AI panel shows an upgrade prompt, your plan's monthly AI credit limit has been reached.

4) Document upload says it was truncated

Cause: The document exceeds the extraction size limit.

Fix:

  • Upload a smaller section of the document.
  • Use a focused prompt in the AI prompt bar ("Extract decisions only", "Summarise the requirements section").
  • Split the document into sections and upload each separately.

5) Sync conflict — my note reverted to an older version

Cause: Last-write-wins merge resolved in favour of an older edit from another client.

Fix:

  • Re-apply your change and keep the tab focused until the sync indicator shows "Saved".
  • If the note had a recent version you need to recover, check Version history in the note overlay.

6) Stripe billing page looks out of date

Cause: Stripe webhook processing may be slightly delayed.

Fix:

  • Refresh the Subscription page — the UI polls for updates after checkout.
  • If the page still shows the wrong plan after a minute, contact support.

7) The canvas feels slow with many notes

Cause: Large boards with 50+ notes can stress canvas rendering.

Fix:

  • Use the Notes Directory and search instead of panning through the full canvas.
  • Consider splitting a very large board into multiple focused boards.

8) I can't edit as a collaborator

Cause: The Free plan allows view-only access for invited collaborators.

Fix:

  • Ask the board owner to upgrade to the Pro plan, which allows up to 5 editor seats.
  • The board header will show a "View Only" badge if you are in view-only mode.

9) Export file is empty or incomplete

Cause: The board state hasn't fully loaded, or the tab went offline before notes finished syncing.

Fix:

  • Wait for the sync indicator to show "Saved" before exporting.
  • Refresh the page, wait for full hydration, then retry the export.

10) I deleted a note and need to recover it

Fix:

  • Immediate undo: press Ctrl / Cmd + Z right after deletion to restore the note.
  • Changelog: if available in your plan, look in the board's change history for a recent snapshot.
  • If neither works, contact support with the board ID and approximate deletion time.

See also

CloudflareGlossary