---
title: "Feature: #65584 - Add image cropping"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-65584"
source: "Changelog/7.2/Feature-65584-AddImageCropping.rst"
modified: "2026-09-14T09:47:36+00:00"
---

# Feature: #65584 - Add image cropping

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

## Description

A new functionality is introduced that allows the editor to define image cropping settings to a *sys_file_reference*.

The current support crop setting is a comma separated string defining: offsetX,offsetY,width,height

## Impact

The value set for a *sys_file_reference* will be passed through to the image rendering of TYPO3 by default.
The new option of *sys_file_reference* is defined as exclude field in TCA so it needs to be enabled for editors.

Disable cropping of image when used with *typoscript* rendering:

```typoscript
# Disable cropping for all images
tt_content.image.20.1.file.crop =
```

Set custom cropping setting for when used with *typoscript* rendering:

```typoscript
# Overrule/set cropping for all images
tt_content.image.20.1.file.crop = 50,50,100,100
```

Disable cropping of image when used in *fluid*:

```html
<f:image image="{imageObject}" crop="" />
```

Set custom cropping setting for image when used in *fluid*:

```html
<f:image image="{imageObject}" crop="50,50,100,100" />
```