---
title: "Figures and diagrams"
manual: "How to Document"
version: "main"
permalink: "https://docs.typo3.org/permalink/h2document:rest-images-diagrams"
source: "Reference/ReStructuredText/Graphics/Index.rst"
modified: "2026-09-14T09:38:54+00:00"
---

# Figures and diagrams

You can upload images in any folder below `Documentation` and use it like that:

**Documentation/MyDocs.rst**

```plaintext
..  figure:: /_Images/a4.jpg
    :alt: some image

    This is the image caption

```

For details see [Using images in ReST documentation](https://docs.typo3.org/permalink/h2document:images).

You can also use [Embedded PlantUML diagrams](https://docs.typo3.org/permalink/h2document:plantuml-diagrams).

> [!WARNING]
> **Attention**
>
> For official and Core manuals please follow the
> [Guidelines for creating images](https://docs.typo3.org/permalink/h2document:guidelines-for-images).

-   [Images](https://docs.typo3.org/permalink/h2document:images)
-   [Zoom and lightbox](https://docs.typo3.org/permalink/h2document:image-zoom)
-   [Float and alignment](https://docs.typo3.org/permalink/h2document:image-float-alignment)
-   [PlantUML diagrams](https://docs.typo3.org/permalink/h2document:plantuml-diagrams)