> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Editing with Craft Assistant

> Let the Assistant make changes directly in your documents — add content, apply styling, create subpages, and more.

Craft Assistant can update your documents directly. You can ask it to add content, apply styling, create subpages, reorganize sections, and more.

## Explore and Execute modes

Craft Assistant has two modes:

* **Explore** — The Assistant reads your document and proposes changes. You review and approve before anything is modified.
* **Execute** — The Assistant reads your document and applies changes directly. You see edits appear in real time.

Use the mode selector at the bottom of the Assistant panel to switch between them.

<img src="https://mintcdn.com/craft-support/8R3j8_MOUDKwTvNH/images/ai-assistant/editing/en/content/mode-selector.png?fit=max&auto=format&n=8R3j8_MOUDKwTvNH&q=85&s=c2a4928c6e76279109d71d4a69aaa6de" alt="Mode selector showing Explore and Execute options" width="442" height="136" data-path="images/ai-assistant/editing/en/content/mode-selector.png" />

## What the Assistant can do in Execute mode

The Assistant can:

* **Create and modify text** — headings, paragraphs, lists, callouts, and code blocks
* **Style your document** — highlights, colors, backgrounds, dividers, and visual styling
* **Create subpages** — add new pages nested inside your document
* **Create new documents** — add documents in your Space or duplicate existing ones
* **Create folders** — organize content into new folders
* **Move documents and folders** — rearrange your Space structure
* **Delete content** — remove blocks, documents, or folders
* **Reorganize sections** — move and restructure content

## Sessions

* Sessions **sync across your devices**.
* You can run **multiple sessions in parallel**.
* A session pauses after **5 minutes** of inactivity. Your conversation history is preserved — reopen previous sessions anytime from the session list.
* A **notification dot** appears when a background session completes.

## Starting an editing session

<Steps>
  <Step>
    Open the document you want to edit.
  </Step>

  <Step>
    Open the Assistant panel.
  </Step>

  <Step>
    Switch to **Execute** mode.
  </Step>

  <Step>
    Describe what you want to change.
  </Step>

  <Step>
    Review the result in your document.
  </Step>
</Steps>

<img src="https://mintcdn.com/craft-support/8R3j8_MOUDKwTvNH/images/ai-assistant/editing/en/content/execute-session.png?fit=max&auto=format&n=8R3j8_MOUDKwTvNH&q=85&s=e7d358f19991a87b7cb76dd831671763" alt="Assistant executing edits in a document" width="1568" height="900" data-path="images/ai-assistant/editing/en/content/execute-session.png" />

## Undo and reverting

<Tip title="One-step undo">
  **⌘Z (Ctrl+Z)** undoes the full last Assistant action as one step — not individual edits, but everything the Assistant did in its last response. You can undo multiple actions by pressing ⌘Z repeatedly.
</Tip>

You can also ask the Assistant to revert or adjust what it changed.

## Tips for better results

* Be specific about what you want changed.
* Start with smaller edits before large rewrites.
* Try **Fast** first — it handles most edits well and uses less of your quota. Switch to **Max** for complex multi-section restructuring.
* Review changes after each request.

## Which models support editing

| Model                       | Can edit | Notes                   |
| --------------------------- | -------- | ----------------------- |
| **Max** (Claude Sonnet 4.6) | Yes      | Best for complex edits  |
| **Fast** (Claude Haiku 4.5) | Yes      | Good for quick edits    |
| **Core**                    | No       | Read-only conversations |
| **On-device**               | No       | Read-only, local models |

## Usage

Editing uses more of your quota than read-only conversations because the Assistant performs multiple steps (reading, planning, and applying). Exact usage depends on document size and request complexity. Use **Fast** for simpler edits to stay efficient.

## Platform availability

<Tabs>
  <Tab title="macOS">
    Full editing support at document-level and space-level.
  </Tab>

  <Tab title="iOS">
    Full editing support at document-level and space-level on iPad and iPhone.
  </Tab>

  <Tab title="Windows">
    Assistant is available. Execute mode is coming later.
  </Tab>

  <Tab title="Web">
    Assistant is available. Execute mode is coming later.
  </Tab>
</Tabs>

## Related Articles

<CardGroup cols={2}>
  <Card title="Using Craft Assistant" href="/en/ai-assistant/using">
    Learn how to start conversations and work with modes
  </Card>

  <Card title="Choosing AI Models" href="/en/ai-assistant/models">
    Pick the best model for editing tasks
  </Card>

  <Card title="Usage & Limits" href="/en/ai-assistant/usage">
    Understand AI usage for editing and other tasks
  </Card>

  <Card title="Custom Prompts" href="/en/ai-assistant/custom-prompts">
    Create reusable editing instructions
  </Card>

  <Card title="Document Review" href="/en/ai-assistant/document-review">
    Get AI feedback before applying edits
  </Card>
</CardGroup>