Workspace

Long-form, shared documents for your team — handbooks, runbooks, playbooks, meeting notes — built on a hierarchical page tree and a rich-text editor.

#Create a workspace

A workspace is a container of pages. You can have as many workspaces as you need — a common setup is one per team or per topic (Engineering, Sales, Client Onboarding).

Click New Workspace on the Workspace page and fill in the modal:

FieldTypeDescription
name*textDisplay name on the workspace card and header.
descriptiontextareaShort summary shown on the card.
iconemoji picker10 emoji options for quick visual recognition.
colorcolor picker8 palette colors for the workspace card.
isPublictogglePublic means everyone in your org can see it. Private workspaces are restricted to explicitly-invited members.

#Pages & folders

Inside a workspace, the left sidebar is a tree of pages and folders. Folders group related pages; pages hold actual content. The tree is unlimited in depth — nest as deeply as you like.

S
Search...
DB
Engineering Handbook
Workspace · shared with 8 members
Pages
📁Getting Started
Onboarding
Local setup
📁Architecture
Overview
Auth flow
Data model
📁Runbooks
Onboarding
Last edited by Marcus · 2h ago
Welcome to the team! This page walks you through your first week.
Day 1 — Accounts & access
Get your SynqHub login from your manager
Enable 2FA (Settings → 2FA)
Join #general in team chat
Day 2 — First project
💡 Tip: ask your buddy to pair on your first pull request.
Workspace — page tree on the left, BlockNote editor on the right

What you can do in the tree:

  • Add page / Add folder — buttons at the top of the sidebar. Both take a parent folder (root by default) and a name.
  • Drag to reorder within the same parent folder.
  • Right-click (or the kebab menu) for Rename, Move up / down, Delete.

#The editor

Pages are edited with BlockNote — the same block-based editor used for contracts. You get headings, lists, tables, code blocks, quotes, callouts, images, links, and the usual inline formatting. Changes save automatically when you leave a block; a manual Save button is also available.

Page titles are editable inline at the top of the editor — no modal required. Edit, commit with Enter, and the title updates in the sidebar tree immediately.

Not yet available
Version history, in-line comments, and @mentions on pages are not yet available. For collaboration on a page, coordinate via your usual comms for now.

#Sharing & roles

Each workspace has its own member list. Open Share from the workspace header to add or remove members.

  • View — can read pages but not edit.
  • Edit — can create, edit, and delete pages.
  • Admin — everything Edit can do, plus manage members and delete the workspace.

Public workspaces are visible to every user in your org regardless of this member list — they still need View as a minimum to read anything, but they can discover the workspace in the list.