Pinning documents
Pin documents or folders for fast access. Pins are per-user, private, scoped to the library you're viewing, and synced across your devices in realtime.
Pins are bookmarks. Anything you pin appears in a dedicated Pinned section at the top of the sidebar, with the pushpin icon as its row icon, regardless of where in the folder tree it actually lives.
Pinning a doc or folder
Right-click any document or folder row in the sidebar and choose Pin from the context menu. The pin shows up immediately in the Pinned section at the top of the sidebar.
The same context menu has Unpin when the item is already pinned.
What pins look like
In the Pinned section, the row icon is the pushpin in the theme’s accent color, instead of the usual doc-type icon. This signals at a glance that you’re looking at the Pinned section rather than the regular tree.
Folders and documents both pin. Pinning a folder doesn’t expand it inline in the Pinned section — clicking it jumps you to that folder’s location in the regular sidebar tree.
Pins are per-user
Pins are stored in the pins table keyed on your user ID. They’re private — no one else sees your pins, even if they have access to the same documents. Each user maintains their own pinboard.
Pins are per-library
The Pinned section shows pins for the library you’re currently viewing. If you have a personal library and an org library, each sidebar has its own Pinned section for items in that library.
A pin pointing at a document that’s been moved to a different library still exists in the pins table; it just doesn’t render in your current sidebar.
Realtime sync
The pins hook subscribes to changes on your pins rows in realtime. Pin or unpin in one tab or one device, the change appears in every other open instance immediately. No refresh needed.
What pinning doesn’t do
| Misconception | Reality |
|---|---|
| Pinning grants access | No — pins are bookmarks. Permissions come from the document’s / folder’s ACL. If you lose access to a pinned item, the pin stays but the row shows nothing (the resolver can’t fetch the resource). |
| Pinning changes who sees the doc | No — pins are per-user and don’t affect other people. |
| Pinning prevents deletion | No — pinned items can still be deleted, and the pin row will disappear from your sidebar when the resource is gone. |
| Pinning travels with sharing | No — when you share a doc, the recipient doesn’t see your pins. Each person pins independently. |