Inline comments & proposals

Content review shouldn't require leaving the page. Docs includes a full comments + proposals review system right in the editor.

Looking for search & replace or the outline minimap for long documents? See Search & replace, outline minimap.

Inline comments

• Comment on a block — hover a block's handle or select text and click Comment; threads attach to the block (or to the selected text range) and render as cards in the right-side gutter.

• Threads and replies — comment cards support threaded replies, edit, delete, resolve/reopen, and emoji reactions (👍 ❤️ 🎉 😄 👀 🚀).

• Comments tab — the right rail's Comments tab lists every thread on the document; the canvas shifts slightly left so cards fit beside the text.

• Mentions in comments — @ mentions work in comment bodies and notify people.

Change proposals

When an agent (or an integration) proposes edits, they arrive as change proposals rather than direct edits:

1. A pending proposals banner appears on the document with the count.

2. Opening a proposal shows a markdown diff — proposed text against the base snapshot — plus the agent's summary and sources (conversations, docs, URLs, or agent runs).

3. Apply commits the change (snapshotting pre-proposal content into version history); Discard rejects it. You can also navigate among multiple pending proposals.

Proposals target the whole document or a single block, and only users with edit permission can apply them — agent output always waits for a human click.