# Insert a PlantUML diagram in Confluence

To insert a PlantUML diagram in Confluence with Capable Diagrams, edit the page, type `/diagram`, choose **Diagram (Capable)** and pick **PlantUML**. Write or paste your PlantUML source, check the preview, then select **Save** and publish the page. The diagram stays as editable text, so anyone with edit access can change it later.

---

## Before you start

* Capable Diagrams is installed on your site and you can edit the page.
* PlantUML has not been turned off by your administrator. If it is missing from the picker, see [Turn diagram languages on or off](https://help.gocapable.com/diagrams/turn-diagram-languages-on-or-off.html).

---

## Steps

1. Edit the page and put the cursor where the diagram should go.
2. Type `/diagram` and choose **Diagram (Capable)**.
3. In the library picker, choose **PlantUML**. It is under **Software and architecture**.
4. Replace the starter diagram with your own PlantUML source, keeping the `@startuml` and `@enduml` lines. The preview redraws as you type.
5. Give the diagram a title in the title field above the editor.
6. Select **Save**, then publish the page.

📝

**Without editing the page first:** select **Capable** in the byline under the page title, type `plantuml` in **Search capabilities**, pick **PlantUML** under **Diagram libraries** (or a PlantUML template under **Templates**), write your diagram and select **Insert**.

---

## If it does not work

* An error in place of the diagram usually means a syntax problem. The text editor points at the broken line. See [Diagram error messages](https://help.gocapable.com/diagrams/diagram-error-messages.html).
* **Save** stays greyed out until the diagram has a title and some source.
* PlantUML is drawn by a rendering service rather than in your browser. If nothing renders on any PlantUML diagram, see [Diagram does not render](https://help.gocapable.com/diagrams/diagram-does-not-render.html).

---

## Related

### [PlantUML](https://help.gocapable.com/diagrams/plantuml.html)

What PlantUML draws, and its syntax.

### [PlantUML examples](https://help.gocapable.com/diagrams/plantuml-examples.html)

Working PlantUML you can paste.

### [UML diagrams](https://help.gocapable.com/diagrams/uml-diagrams.html)

Which UML diagram to use when.

### [Insert a diagram](https://help.gocapable.com/diagrams/insert-a-diagram.html)

Every way to put a diagram on a page.

---

_UML as text, reviewed like code, drawn on the page._