# Create a diagram with AI in Confluence

To create a diagram with AI in Confluence, insert **Diagram (Capable)**, select **Studio** (or **Generate** in the library picker) and describe the diagram you want. Diagram Studio writes it as real diagram source, in a language that suits it, such as Mermaid, PlantUML, draw.io or D2\. Open it in the editor, check it, then save it.

---

## Before you start

| **You need**                | **Why**                                                                                                                                                                                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Edit permission on the page | You create the diagram while editing the page.                                                                                                                                                                                                                                               |
| AI turned on for your site  | If an administrator has switched off **AI integrations**, **Studio** and **Generate** are hidden. See [Turn off AI diagramming in Confluence](https://help.gocapable.com/diagrams/turn-off-ai-diagramming-in-confluence.html). |
| The standard Capable app    | Studio is not offered in the Zero Egress edition of Capable Diagrams.                                                                                                                                                                                                                        |

---

## Steps

1. Edit the page, type `/diagram` and choose **Diagram (Capable)**.
2. Select **Studio** at the top of the list, or **Generate** in the library picker.
3. In **Describe the diagram you want...**, say what the diagram shows, the steps or parts, and how they connect.
4. To choose the language, start with it, for example `/mermaid`, `/plantuml`, `/drawio` or `/d2`. Type `/page` to build the diagram from the page you are on.
5. When the result appears, select **Edit in editor**. The diagram opens in its normal editor.
6. Check the relationships and labels, give the diagram a title, then select **Save** and publish the page.

---

## What happens next

The result is an ordinary Capable diagram. Edit it by hand, comment on it, export it or save it as a template, exactly like a diagram you drew yourself. Nothing is locked to AI.

---

## If it does not work

* No **Studio** or **Generate**: AI is switched off for your site, or you are on the Zero Egress edition.
* The diagram came back in the wrong language: ask for it by name, such as `/plantuml`, at the start of your description.
* Relationships are plausible but wrong: the AI only knows what you tell it. Add detail and ask again. See [Writing diagram prompts](https://help.gocapable.com/diagrams/writing-diagram-prompts.html).

📝

Treat the result as a first draft. Read it before you publish, the same way you would check a colleague's work.

---

## Related

### [Diagram Studio](https://help.gocapable.com/diagrams/diagram-studio.html)

The full generate-and-refine surface.

### [Create diagrams with AI](https://help.gocapable.com/diagrams/create-diagrams-with-ai.html)

What to check every time.

### [Writing diagram prompts](https://help.gocapable.com/diagrams/writing-diagram-prompts.html)

Descriptions that get better diagrams.

### [AI and your diagram data](https://help.gocapable.com/diagrams/ai-and-your-diagram-data.html)

What is sent, and when.

### [Turn off AI diagramming in Confluence](https://help.gocapable.com/diagrams/turn-off-ai-diagramming-in-confluence.html)

For administrators.

### [Insert a Mermaid diagram in Confluence](https://help.gocapable.com/diagrams/insert-a-mermaid-diagram-in-confluence.html)

Write the source yourself.

---

_A sentence in, an editable diagram out._