> ## Documentation Index
> Fetch the complete documentation index at: https://docs.diagram.eoeok.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit and export

> Use the diagrams.net editor, automatic saving, AI edits, and export controls.

DiagramAI embeds the diagrams.net editor so every AI-generated shape, connector, label, and style remains editable.

## Edit on the canvas

Use the editor to:

* Move, resize, duplicate, and delete shapes
* Change labels, colors, borders, and typography
* Add connectors and adjust their routes
* Use the shape libraries and layout tools provided by diagrams.net
* Undo or redo recent canvas changes

## Automatic saving

Changes are queued and saved to your workspace automatically. The DiagramAI header shows the current state:

* **Saving** means changes are being sent.
* **Saved** includes the time of the latest successful save.
* **Save failed** provides a **Retry** action.

Wait for **Saved** before closing the tab or returning to the workspace.

<Info>
  DiagramAI keeps a temporary browser draft when needed. If the browser draft is newer than the
  server copy, the editor asks whether you want to restore it.
</Info>

## Edit with AI

<Steps>
  <Step title="Open the AI panel">
    Select the AI action in the editor.
  </Step>

  <Step title="Describe one change">
    Refer to components that already exist and state what should remain unchanged.

    ```text theme={null}
    Rename “API” to “API gateway”, add a rate limiter before it,
    and keep the existing database connections unchanged.
    ```
  </Step>

  <Step title="Send the request">
    Select the diagram type if needed, then submit. You can also use `Command+Enter` on macOS or `Control+Enter` on Windows and Linux.
  </Step>

  <Step title="Review the updated canvas">
    Confirm that the requested change was applied correctly. The updated document is added to the save queue.
  </Step>
</Steps>

## Export

Use the diagrams.net export controls available in the embedded editor:

1. Open the editor's export menu.
2. Choose one of the formats currently offered by the editor.
3. Configure the page, crop, scale, background, or other available options.
4. Download the result and inspect it before sharing.

The set of formats and options is provided by diagrams.net and can vary by format.

## Team editing locks

A team-workspace diagram can have one active editor at a time. If another member holds the lock, the diagram opens in read-only mode and AI editing is disabled. A workspace Owner or Admin can take over the lock when necessary.

See [Team workspaces and permissions](/en/team-workspaces) for the complete role behavior.
