Sharing
Invite collaborators to your spaces with view, edit, or Co-GM permissions, and control access with granular secrets.
Overview
Sharing in Swashbuckler is per-space — when you share a space, the recipient gets access to all content in that space by default. You can then use secrets to hide specific templates, entries, or fields from individual users or from all shared users.
Sharing requires a Swashbuckler account (it's not available in guest mode).
Inviting Collaborators
- Go to Settings > Sharing (or click the share icon in the sidebar)
- Enter the collaborator's email address
- Choose a permission level: View, Edit, or Co-GM
- Click Share
The collaborator will see the space appear in their Shared with you section in the space switcher.
Permissions
| Permission | Can Do | Cannot Do |
|---|---|---|
| View | Browse entries, read content, use search and graph | Edit content, change properties, create or delete entries, drag in board view |
| Edit | Everything View can do, plus: edit content, create entries, change properties, drag in board view, participate in real-time collaboration | See secret content, manage secrets, manage sharing settings, canvas GM tools |
| Co-GM | Everything Edit can do, plus: see all secret content, toggle secrets on entries and templates, pin chat messages, use canvas fog of war and scene controls, announce initiative changes in chat | Manage sharing settings (add/remove collaborators), delete or archive the space |
Secrets
Secrets let you hide content from shared users at three levels:
Template-Level Secrets
Hide an entire template and all its entries from a shared user. The template won't appear in their sidebar, search results, graph view, or anywhere else.
Entry-Level Secrets
Hide a specific entry from a shared user. The entry won't appear in the sidebar, template pages, search, graph, or linked entries for that user.
Field-Level Secrets
Hide a specific property field on a template from shared users. The field won't appear in the entry editor, template page columns, or filter options for that user.
Secret Scopes
Secrets can be set at two scopes:
| Scope | Applies To | Managed In |
|---|---|---|
| Per-user | A single shared user | Settings > Sharing > per-user secret list |
| Space-wide | All current and future shared users | Settings > Sharing > space-wide secrets section |
Space-wide secrets are useful when you want to hide something from everyone you share with, without configuring each user individually.
Managing Secrets
- Go to Settings > Sharing
- For space-wide secrets, use the Space-wide secrets section at the top
- For per-user secrets, click the secrets button next to a collaborator's name
The secret manager shows an expandable list of templates. Under each template, you can check/uncheck:
- The template itself (hides the template and all its entries)
- Individual entries within the template
- Individual fields on the template
Hidden Content Behavior
Hidden content is completely invisible to the affected user — there's no "you don't have access" placeholder or any indication that hidden content exists. Content simply doesn't appear.
The space owner and Co-GMs are never affected by secrets — they always see all content.
Leaving a Shared Space
If you're a recipient of a shared space (not the owner):
- Open the space switcher
- Click the option to leave the shared space
- Confirm the action
Leaving removes your access to the space and switches you to your first owned space.
Sharing and Other Features
- Chat: Every shared space gets a real-time chat channel automatically — message, react, roll dice, and start threads
- Real-Time Collaboration: Automatically activates for shared spaces where the user has edit permission
- Secret Content: The owner can add secret blocks and marks that are invisible to shared users
- Themes: Each user sees their own theme preference in shared spaces — themes are personal, not shared
- Pins: Pins are per-user — each collaborator has their own pinned entries