---
title: "Breaking: #111109 - GFX setting processor_effects renamed to sharpen"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:breaking-111109-1792229915"
source: "Changelog/15.0/Breaking-111109-GFXSettingProcessorEffectsRenamedToSharpen.rst"
typo3-version: "15.0"
typo3-major: 15
type: "breaking"
issue: 111109
forge: "https://forge.typo3.org/issues/111109"
tags: ["LocalConfiguration", "PartiallyScanned", "ext:core"]
rendered: "2026-10-27T20:58:30+00:00"
---

# Breaking: #111109 - GFX setting processor_effects renamed to sharpen {#breaking-111109-1792229915}

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

## Description {#description}

The setting `$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_effects']`
has been renamed to `$GLOBALS['TYPO3_CONF_VARS']['GFX']['sharpen']`,
which is what it does. Its description claimed that it enabled blurring and
sharpening, which it did not.

What the setting does has changed as well. ImageMagick and GraphicsMagick
used to sharpen every scaled JPEG, WebP and AVIF image with
`-sharpen 1x2`, which made edges noticeably harder and the files a quarter
larger. They now sharpen these images with the lighter `-unsharp 1x2+0.25+0`,
and only when they scale them down. A scaled-up image gains next to nothing
from sharpening and is no longer sharpened. Which formats are sharpened does
not change: JPEG, WebP and AVIF, as before; PNG and GIF never were.

The setting is enabled by default, and both the ImageMagick and the
GraphicsMagick preset of the Install Tool enable it. GraphicsMagick sharpens
with the same parameters as ImageMagick.

The upgrade migrates the setting in [`config/system/settings.php`](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/Configuration/Typo3ConfVars/Index.html#file-project-config-system-settings-php).

## Impact {#impact}

Extensions that read the setting `processor_effects` no longer find it.

Installations that sharpened images look slightly softer after the processed
files are generated again, and the processed JPEG, WebP and AVIF files get
smaller. Installations that did not sharpen and have not set the option now
sharpen scaled-down images slightly.

`\TYPO3\CMS\Core\Imaging\GraphicalFunctions->cmds` no longer carries the sharpening parameters.

## Affected installations {#affected-installations}

Extensions that read the setting. The extension scanner reports them.

Installations that process images with ImageMagick or GraphicsMagick.

## Migration {#migration}

Read `$GLOBALS['TYPO3_CONF_VARS']['GFX']['sharpen']` instead.

To keep images unsharpened, set
`$GLOBALS['TYPO3_CONF_VARS']['GFX']['sharpen']` to `false`.