---
title: "Feature: Rendering of the Images element"
manual: "Frontend Theme for Extension Development"
version: "main"
source: "Changelog/2.0/Feature-ImageContentElementRendering.rst"
modified: "2026-09-17T04:52:50+00:00"
---

# Feature: Rendering of the Images element

## Description

The content element **Images** (`CType` `image`) is rendered by the
theme.

No TCA is added for it. The element is registered by **EXT:frontend**, in
`Configuration/TCA/Overrides/225-tt_content-content_type-image.php`, on
TYPO3 v13.4 and v14 alike - what `fluid_styled_content` contributes for it is
the rendering, and that is what this theme now brings itself.

The backend fields of the element decide the layout, and all of them are
honoured:

| Field | Effect |
| --- | --- |
| **Images** | The file references that are rendered, in their sorted order. |
| **Number of columns** | The number of images per row. |
| **Position and alignment** | Rendered as the modifier classes `gallery--above`, `gallery--below`, `gallery--intext`, `gallery--left`, `gallery--center` and `gallery--right`. |
| **Width** / **Height** | A fixed dimension all images are scaled to, with the row scaled down when it would exceed the gallery width. |
| **Enable click-enlarge** | Wraps the image in a link to the original file. No lightbox: this extension ships no JavaScript. |

The **Alternative text**, **Title** and **Description**
of a file reference become the `alt` attribute, the `title` attribute and a
`<figcaption>`.

Every image is rendered with a `width` and a `height` attribute, so the
browser can reserve its box before the file has loaded.

## Impact

An installation using the theme no longer renders the TYPO3 "no rendering
definition" notice for **Images**.

The width the gallery is computed for is a constant and should match the width
the layout gives the content column:

```typoscript
theme.media {
    maxGalleryWidth = 1200
    maxGalleryWidthInText = 420
}
```

The markup is generated from
`Resources/Private/Templates/ContentElements/Image.html` and
`Resources/Private/Partials/ContentElement/Gallery.html`, which the Fluid
path constants redirect together with every other template - see
[Configuration](../../Configuration/Index.html#configuration).