The Writing Copilot is your AI writing partner inside the editor. It comes in two forms that work together: quick **inline commands** in the block palette, and a...
The Writing Copilot is your AI writing partner inside the editor. It comes in two forms that work together: quick **inline commands** in the block palette, and a...
The Writing Copilot is your AI writing partner inside the editor. It comes in two forms that work together: quick inline commands in the block palette, and a conversational Copilot dock that can draft, edit, and reorganize content with your approval.
Inline AI commands
In the block editor, press <kbd>/</kbd> on a new line to open the palette. The AI section at the top has three commands:
| Command | Shortcut | What it does |
|---|---|---|
| **AI: Continue writing** | `/ai continue` | Drafts what comes next at the cursor, matching the page's voice and structure. |
| **AI: Generate table** | `/ai table` | Builds a table from the surrounding content. |
| **AI: Generate diagram** | `/ai diagram` | Turns a description into a [Mermaid](/write/blocks-and-components#diagrams-math) diagram. |
These are the fastest way to get unstuck — drop your cursor where you want help and pick the command.
The Copilot dock
Open the Copilot from the dock button in the app. It's a chat where you describe what you want in plain language and the copilot proposes the changes. The composer accepts more than text — you can attach screenshots, notes, or a spec to ground the request.
What it can help with depends on where you are:
- With a page open in the editor — it acts as your Writing Copilot: drafting sections, rewriting passages, restructuring a page, and turning a spec or screenshot into documentation. It only edits draft pages (in-review and published pages are read-only).
- Across your workspace — it's the Workspace Copilot: it can explain how a setting works, change project settings, manage members and billing, set up new projects, and reorganize your content tree (create, move, or delete pages and spaces).
Ask mode vs. Auto mode
The dock has two modes, switchable at the top:
| Mode | Behavior |
|---|---|
| **Ask mode** | Answers and **proposes** changes for you to review before anything is applied. |
| **Auto mode** | Applies document edits automatically when it's safe to do so. |
Use Ask mode when you want to stay in control of every edit; use Auto mode to move quickly on low-risk changes.
Proposed actions
When the copilot wants to change something, it shows a Proposed actions card summarizing exactly what it will do — block edits (with a before/after preview), reorders, or content-tree changes like creating or moving pages. You decide:
- Apply — accept the proposed actions (you can apply a subset by selecting individual rows).
- Reject — discard an action and let the copilot continue.
Nothing changes until you apply, so you always have the final say.
Context awareness
The copilot reads the surrounding page and your workspace so its output fits:
- It matches the heading structure and voice of the existing content.
- It reuses terminology already established on the page.
- It respects your Workspace AI policy — voice, reading level, preferred terms, and banned terms.
Copilot vs. Improve with AI
These two features overlap but differ in intent:
| Col 1 | Writing Copilot | [Improve with AI](/ai/improve-with-ai) |
|---|---|---|
| **Trigger** | You give an instruction | One click, no instruction |
| **Use** | Generate, transform, or restructure content | Fix the issues the quality scan flagged |
| **Output** | New or rewritten content, proposed actions | An improved full-page draft |
Use the copilot when you know what you want it to do; use Improve with AI for a fast, scan-driven cleanup.
Models and speed
The copilot uses the Spark tier by default for low-latency responses and escalates to Atlas for complex generation. Admins can pin a tier with the Copilot tier override in the Workspace AI policy.