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

# Diagrams

> How to draw network paths, processes and escalations in Flexxible KB, show them in pages and edit them as a team or with Teammate.

Diagrams are for drawing how things connect: a network path, a process, who to call. A diagram is drawn once and can be shown in any page. When someone edits it, it changes in all of them.

Diagrams are turned on by default. An owner or administrator can turn them off in **Settings** → **Diagrams**.

## Create a diagram

* **From Diagrams.** In the sidebar, select **Diagrams** and then **New diagram**.
* **From a page.** In the editor, type `/` and choose **Diagram**. You can draw a new one or show one your organization already has.
* **From the command palette.** `Ctrl` + `K` and **New diagram**.

## The diagram editor

![Diagram editor with a network diagram: canvas, toolbar at the bottom and header with the title, the save status and access to the history.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-diagram-editor.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=80960720be301fa7677694f64f97b569)

The editor is a free canvas with shapes, arrows, text, freehand strokes and images. The toolbar is at the bottom and the colors follow the theme you've chosen.

* **It saves itself.** The header shows *Saving…* or *Saved*. Offline, changes are synced once you're back online.
* **Draw as a team.** You see other people's pointers, with their names, and what they draw as they draw it. You can follow someone by selecting their avatar.
* **Title.** Select the title in the header to change it.
* **Export image** downloads the diagram as an image.
* **Copy link** copies the diagram's address.

Images you add to a diagram can be PNG, JPEG, GIF or WebP under 10 MB.

### Diagram history

**History**, in the editor header, shows the diagram's versions, with who made each change. Choose a version to view it and select **Restore this version** if you need it.

The history keeps the 100 most recent versions of each diagram, up to about 50 MB, and always the 10 most recent.

### Draw with Teammate

In the editor, `Ctrl` + `J` (`⌘` + `J` on Mac) or the Teammate icon in the header opens the **Draw with Teammate** panel. Describe what you want to draw or the change you need:

* "Draw how a laptop at home reaches the office network through the VPN."
* "Draw who an incident is escalated to, starting with first-level support."
* "Tidy up the diagram and align the elements."
* "Compare this with our pages and say what's out of date."

Select elements on the canvas to indicate which ones you mean. The drawing changes while Teammate works, and anyone can undo it.

## Diagrams in pages

A diagram inserted in a page is shown drawn, like any other image.

* In reading mode, select it to open it large. From there you can view it at **Actual size** or **Fit to window**.
* In editing mode, double-click to draw. The block menu offers **Edit diagram**, **Open in new tab**, **Copy link** and **Remove from page**.
* **Remove from page** doesn't delete the diagram: it stays in **Diagrams** and in the other pages that show it.

If a page has many large diagrams, some are only shown when you ask, with **Show diagram**.

## Organize diagrams

The **Diagrams** screen lists all diagrams with their last modification and the pages each one is in.

![Diagrams screen: folders, filters and the list of diagrams with a thumbnail, their author and the pages each one appears in.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-diagrams-list.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=07d84cc77da9348814c1ad9eadfaca6a)

* **Search.** By title, by the words the diagram contains or by a page it's in.
* **Filters.** **All**, **In pages**, **In no page**, **Made by me** and **Changed by me**.
* **Folders.** **New folder** creates a folder. Drag a diagram into a folder or use **Move to…** in its menu. The diagram's address doesn't change when you move it, and the pages that show it keep showing it.
* **Each diagram's menu.** **Open**, **Rename**, **Duplicate**, **Move to…** and **Delete**.

When you delete a diagram, the pages that showed it indicate that it was deleted. The notice includes **Undo**.

If your organization uses [spaces](https://docs.flexxible.com/en/features/flexxible-kb/spaces.md), the list can be filtered by space. Any page can show a diagram from any space.

## Diagrams and agents

Agents also read and draw diagrams. When reading a page, an agent receives a text description of each diagram: its elements and one line for each arrow. That way it can follow a network path or an escalation just as a person would by looking at it.

Agents with write permission can create and modify diagrams from a description. Their changes are kept in the diagram's history.

## Turn off diagrams

In **Settings** → **Diagrams**, **Turn on diagrams** controls the feature for the whole organization. With diagrams turned off:

* **Diagrams** disappears from the sidebar, the `/` menu and the agents' tools.
* Pages keep showing theirs, read-only.
* Nothing is deleted.

## Next steps

* [Write and edit pages](https://docs.flexxible.com/en/features/flexxible-kb/editor.md)
* [Teammate](https://docs.flexxible.com/en/features/flexxible-kb/teammate.md)
