Sharing and permissions
Updated 7/27/2026
Sharing and permissions
Vault documents are private by default. Access is checked server-side for every document read or write.
Roles
Vault supports three document roles.
| Role | Can read | Can edit | Can share | Can publish | Can archive |
|---|---|---|---|---|---|
| Owner | Yes | Yes | Yes | Yes | Yes |
| Editor | Yes | Yes | No | No | No |
| Viewer | Yes | No | No | No | No |
Friends and sharing
You can search for users by nickname, username, or email when adding friends or sharing a document. Sharing stores permissions against the stable internal user ID, not the username.
That means users can change their username without breaking friendships, shared documents, or collaboration access.
Public documents
Owners can publish selected documents. Published documents receive a stable public slug and are readable without signing in.
Unpublishing makes the document private again while keeping the slug reserved.
Assets in shared or public documents
Uploaded assets are private by default.
When an asset is linked to a document, signed-in users who can read that document can also render that linked private asset through the document context. This is what lets editors and viewers see images or PDFs inside shared private documents.
Publishing a document does not publish its embedded assets. If a public document embeds a private asset, logged-out readers see an unavailable/private placeholder for that embed. The publish panel warns the owner when private linked assets are embedded.
To show an asset publicly, publish the asset itself from the asset library.
Collaboration
Owner and editor sessions can connect to the collaboration server. Viewers can read the document but cannot join as editors.