Notion AI: The AI that stayed inside the document
Notion never built a chat destination. The model lives in the editor — space to draft, highlight to edit, accept or discard — and its answers cite the workspace pages they came from.
An independent reading of Notion AI's interface, grounded in Notion's official help center. Quotes are verbatim from the linked official pages. The product UI may differ from what is described.
Draft in place, not in a chat window
- The prompt appears on the page itself — press space on a new line and the AI writes directly into the document.
- Context comes from the workspace: @-mention pages, people and dates instead of pasting content into a side panel.
“To draft or generate new text, press the space key on a new line and enter a prompt. Notion AI writes directly on the page, and you can @-mention pages, people, and dates to give it context.”
Source: Notion Help Center — Use Notion AI to write better, more efficient notes and docs ↗
An edit is a review loop
- Editing a selection is not an overwrite — the suggestion arrives as something you accept, discard, or send back for another try.
- The original text survives until the reader explicitly keeps the new one; the AI proposes, the writer disposes.
“Give it a prompt like fix grammar, make it shorter, or change the tone, then accept, discard, or ask it to try again.”
Source: Notion Help Center — Use Notion AI to write better, more efficient notes and docs ↗
One agent across the workspace and beyond
- The same agent summarizes the page you're on or ranges across Notion and connected tools — the surface doesn't change, only the scope.
- Multi-step tasks run from the same entry point; there is no separate 'agent mode' to learn.
“Ask it to summarize the current page, find something across Notion and connected tools like Slack or Google Drive, or take a multi-step task from start to finish.”
Source: Notion Help Center — Use Notion AI to write better, more efficient notes and docs ↗
Answers cite the pages they came from
- Answers pulled from connected apps carry citations back to the original material — provenance is part of the answer, not an afterthought.
- The claim and its source travel together, so trust is checkable without leaving the thread.
“With Notion AI Connectors, your questions can also pull in relevant information from your connected apps, with citations to the sources used.”
Source: Notion Help Center — Notion AI Connectors overview ↗
The most capable models ship in two variants — one with additional safety measures, and one restricted to approved organizations. When rendering tokens incrementally, treat the stream as a first-class UX concern rather than a progress hack .
For actions with real-world consequences, a human-in-the-loop gate is not optional — it is the difference between a helpful assistant and an uncontrolled agent .
Scope is a control, not a prompt trick
- An 'All sources' picker in the chat box narrows which page or source the AI analyzes — the user sets the boundary explicitly.
- Scoping is UI, not prompt engineering: the reader never has to write 'only look at X' and hope.
“Look for the All sources option at the bottom of your Notion AI chat box. Select the page or source you want Notion AI to analyze for a specific answer.”
Source: Notion Help Center — Everything you can do with Notion AI ↗
- README.md12 KB
- src/lib/registry.ts48 KB
- design-system.css21 KB
Citations you can inspect
- In AI Meeting Notes, hovering a citation previews the exact transcript snippet behind it — verification is a hover, not a hunt.
- Clicking jumps to the line in the transcript; the popover and the source never disagree because they are the same reference.
“You’ll also find citations to your transcript in your meeting notes summary. Hover over a citation to see the snippet of your transcript that’s been referenced.”
Source: Notion Help Center — Notion AI FAQs ↗
Design takeaways
- Put the model where the work already is; a separate chat window is a context switch you imposed on the user.
- AI edits should arrive as proposals with accept/discard — never silent overwrites.
- Citations belong in the answer itself, inspectable on hover and jumpable on click.
- Make scope an explicit control; 'All sources' beats praying the prompt was clear.
Sources
Build it with our components
The message input at the heart of an AI chat app — file attachments, model picker, tool toggles, voice, and a send button that turns into stop.
Citation UIInline citation markers in generated text — numbered footnotes that reveal the source in a hover preview card.
Citation PopoverA citation marker that shows the passage it came from — fixed positioning that survives a scrolling answer, touch and keyboard, and an honest state for a number the model invented.