Spaces & Permissions
Spaces are the top-level containers in Ink. Think of them as separate areas for separate teams — Engineering, Design, Ops, Clients — each with its own members, templates, and index page.
Creating a space
Sidebar → + Add space.
- Name (displayed in the sidebar and breadcrumbs)
- Icon (emoji or upload)
- Visibility (private, workspace-wide, or public)
- Default page template (optional)
Space-level permissions
Permissions cascade: a space's default permission applies to every page inside it, unless a page overrides.
| Role | Can… |
|---|---|
| Admin | Full control: rename/delete the space, manage members, change settings. |
| Editor | Create, edit, and delete pages. Invite editors. |
| Commenter | Read pages, leave comments. Cannot edit. |
| Viewer | Read pages only. |
Assign roles in Space menu → Members.
Visibility
- Private — only invited members see the space. Doesn't appear in the directory for non-members.
- Workspace-wide — every workspace member automatically has viewer access. Admins/editors still need explicit roles for elevated permissions.
- Public — opt-in per space. Pages published to the public site respect page-level publish toggles, not space visibility.
Index page
Every space has an index page (root). Default content:
- Space description
- A "New" section listing the most recently created pages
- A "Pinned" section (drag pages here to pin)
- A "By tag" section grouping pages by tag
The index is fully customizable — it's just another Ink page.
Nesting
Pages nest inside pages, inside pages. There's no depth limit in the data model; the sidebar collapses deep trees gracefully.
Common patterns:
- Engineering space →
Projects→ individual project pages →Tech specs,Meeting notes,Runbooks. - Ops space →
Policies→ individual policy docs.People→ individual team member pages with 1:1 notes. - Client space → one page per client → sub-pages for
Notes,Contract,Deliverables.
Moving pages
Drag a page in the sidebar to move it — between parents, between sections, or between spaces. Moves preserve the page's history, comments, and inbound links.
Templates
Per-space templates live under Space menu → Templates.
Create one, then use New page → From template anywhere in the
space.
Built-in templates include:
- Meeting notes
- Project brief
- Retrospective
- RFC
- Runbook
- 1:1 notes
Edit any of them, save, done.
Archiving
Archive a space (or a single page) from its menu. Archived content is hidden from the sidebar and default search, but remains retrievable from Settings → Archived.
Permissions audit
Space menu → Members → Access history shows who had what role when, plus every invite and role change.
Data model
Spaces are stored in spaces. Pages in pages. Space members
in space_members. See Database Reference
for columns.
Example structure
📁 Engineering (workspace-wide viewer, team members editor)
📄 Index
📁 Projects
📁 Auth revamp
📄 RFC
📄 Implementation notes
📄 Meeting notes
📁 Runbooks
📄 Incident response
📄 Deploy checklist
📁 Design (private, design team only)
📄 Index
📁 Design reviews
📄 2026-04-14 review
📁 Clients (private, account team only)
📁 Acme Corp
📄 Account plan
📄 QBR Q1 2026