---
title: "Feature: #79883 - Add cropVariant support to TypoScript rendering of images"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-79883"
source: "Changelog/8.7/Feature-79883-AddCropVariantSupportToTyposcriptRenderingOfImages.rst"
typo3-version: "8.7"
typo3-major: 8
type: "feature"
issue: 79883
forge: "https://forge.typo3.org/issues/79883"
tags: ["FAL", "Frontend", "TypoScript"]
rendered: "2026-09-24T21:45:06+00:00"
---

# Feature: #79883 - Add cropVariant support to TypoScript rendering of images {#feature-79883}

See [forge#79883](https://forge.typo3.org/issues/79883)

## Description {#description}

The introduction of the new crop variants [forge#75880](https://forge.typo3.org/issues/75880) broke the handling of
cropped images when using TypoScript to render file(reference)'s. This feature
fixes this and introduces a new TypoScript option to use a different cropVariant.

To use a different `cropVariant` as default you can provide the
`cropVariant` name now in your TypoScript configuration.
If `cropVariant` isn't provided the default variant will be used.

```typoscript
# Use specific cropVariant for the images
tt_content.image.20.1.file.cropVariant = mobile
```

## Impact {#impact}

If multiple cropVariants are available (see [forge#75880](https://forge.typo3.org/issues/75880)) you can now configure
which variant to use with the `cropVariant` option of `imgResource`.