Troubleshooting
A bookmark won't save
Check the required fields. Both Title and URL are required. If either is blank the form will not submit.
If both fields are filled in and saving still fails:
- Make sure the URL is not empty after trimming. A string of spaces counts as blank.
- Check your internet connection — Bookmarks requires a live connection to persist changes.
- Verify you have write permission in the target circle. If the permission is missing you'll see a "Permission Required" notice on the form.
- If the form shows a "No circle selected" error, make sure you have at least one circle with write access and that it is set as your default circle (top bar → circles icon).
- Refresh the page and try again. A stale session can occasionally block writes.
I can't find a bookmark I saved
Bookmarks are scoped to circles. A few things to check:
You're in the right view. If you saved a bookmark inside a folder, it won't appear directly in All Bookmarks unless you scroll to it — but the search bar in All Bookmarks does search across all folders. Type a keyword from the title or URL to locate it.
Filters are narrowing the results. On the All Bookmarks page, make sure you haven't left a search term in the search bar from a previous session. Click Clear to reset the search.
It belongs to a different circle. All Bookmarks shows content from every circle you are a member of, but if you recently lost access to a circle the bookmarks from that circle will no longer be visible. Check with the circle administrator.
You're looking in the wrong folder. Open the folder you think it was saved in and use the search bar inside the folder content view to filter by title or URL.
A folder is missing from the sidebar
The sidebar shows only root-level folders (folders with no parent folder). If the folder you're looking for is a subfolder, it will appear inside its parent folder's content view, not directly in the sidebar.
To find it:
- Open the parent folder from the sidebar.
- Use All Folders (sidebar shortcut) to search across all root folders by name.
- If the folder belongs to a circle you no longer have access to, it won't appear at all.
The circle field is locked on the bookmark or folder form
The circle field becomes read-only in two situations:
The bookmark is inside a folder. The bookmark's circle is inherited from its folder and cannot be changed independently. The form shows the notice: "The circle is determined by the folder this bookmark belongs to." To change the circle, move the bookmark to a folder in the target circle or remove it from its current folder first.
You don't have ADMIN permission on the current circle. Moving an item to a different circle requires ADMIN access on its current circle. If you only have READ or WRITE access, the field is locked. Contact the circle administrator to request ADMIN permission or ask them to move the item on your behalf.
I imported a JSON file but got errors
The import validator checks the entire file before writing anything. Common error messages and how to fix them:
| Error message | Fix |
|---------------|-----|
| "File is too large" | The file exceeds 512 KB. Split it into smaller files or shorten descriptions. |
| "The file is not valid JSON" | Your file has a syntax error. Validate it at jsonlint.com before trying again. |
| "folderName: is required" | Add a folderName key at the root of the JSON object. |
| "folderName: must not be blank" | The folderName value is an empty or whitespace-only string. Give the folder a real name. |
| "bookmarks: must contain at least 1 item" | The bookmarks array is present but empty. Add at least one bookmark entry. |
| "bookmarks[N].title: is required" | Bookmark at position N is missing a title field. |
| "bookmarks[N].url: is required" | Bookmark at position N is missing a url field. |
| "bookmarks[N].title: must have length <= 300" | Shorten the title for that entry. |
| "bookmarks[N].url: must have length <= 2000" | Shorten the URL for that entry. |
| "bookmarks[N].description: must have length <= 1000" | Shorten the description for that entry. |
| "someField: additional properties are not allowed" | Remove unknown fields. Only folderName and bookmarks are allowed at the root; only title, url, description, tags, and favorite are allowed per bookmark. |
| "You do not have access to the selected circle" | The circle you chose in the dropdown is not in your current session. Try logging out and back in, then re-import. |
All errors are shown at once — fix every issue listed, then re-upload the corrected file. Either the entire import succeeds or nothing is written; there are no partial imports.
A bookmark I deleted keeps reappearing
This usually means the page is showing a cached version. Try:
- Performing a hard refresh of the page (Ctrl+Shift+R / Cmd+Shift+R).
- Navigating away (e.g. click another folder) and then returning to the view.
If the bookmark genuinely reappears after navigating away, it may have been re-created by another user in the same circle.
The favicon isn't showing for a bookmark
Favicons are fetched from the saved URL's domain. They may not display if:
- The URL is incorrect or the site no longer exists.
- The site does not expose a standard favicon.
- Your network blocks requests to external domains for favicons.
This is purely cosmetic — the bookmark still works normally. The app shows a default bookmark icon when no favicon is available.
I can't delete a bookmark or folder
Delete requires write permission on the item's circle. If the Delete button is absent or disabled:
- You may only have read access to that circle. Contact the circle administrator to request write access.
- You may be looking at content in a circle where your role has recently changed.
Note: deleting a folder also deletes all bookmarks inside it. This action cannot be undone, so the app asks for confirmation before proceeding.
Buttons and actions are greyed out or missing
When a button (New Bookmark, Edit, Delete) appears greyed out or is absent entirely, it means you lack the required permission for that action in the item's circle. Hover over a disabled button to see the tooltip explaining which permission is needed. Contact the circle administrator to request the appropriate access level.
I lost access to a circle
Circle membership is managed by the circle administrator. If bookmarks or folders that were previously visible have disappeared:
- Ask the circle administrator to re-add you to the circle.
- Check your account settings (top bar → user icon) to confirm which circles you currently belong to.
- If you were removed from a circle, any bookmarks you saved there are still stored — they just won't be visible until your membership is restored.