Catalogue / notion-2021-block-data-model

Notion models all workspace data as UUID-keyed blocks with upward permission pointers and queued client transactions

Notion. Block data model and client-server sync engine.

Organisation
Notion
Evidence
Reported from production
Source
The data model behind Notion's flexibility

Notion, published 2021-05-18

Records

Decision#d1

Represent all content as uniform blocks with properties decoupled from block type

Decision#d2

Store a separate upward parent pointer on every block exclusively for permission inheritance

Decision#d3

Commit batched edits via optimistic client queues, before/after server validation, and WebSocket version pings

Sign in to read what was chosen, what was rejected and what it cost, each with its place in the source. An account is free.