---
title: "Breaking: #107403 - Remove LocalPreviewHelper + LocalCropScaleMaskHelper"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:breaking-107403-1757082780"
source: "Changelog/14.0/Breaking-107403-RemoveLocalPreviewHelperAndLocalCropScaleMaskHelper.rst"
typo3-version: "14.0"
typo3-major: 14
type: "breaking"
issue: 107403
forge: "https://forge.typo3.org/issues/107403"
tags: ["PHP-API", "FullyScanned"]
rendered: "2026-09-28T19:48:07+00:00"
---

# Breaking: #107403 - Remove LocalPreviewHelper + LocalCropScaleMaskHelper {#breaking-107403-1757082780}

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

## Description {#description}

The helper classes for preview and CropScaleMask (CSM) image generation
prevented further unification of the File Abstraction Layer (FAL) image
processing API.

The two helper classes
`\TYPO3\CMS\Core\Resource\Processing\LocalPreviewHelper` and
`\TYPO3\CMS\Core\Resource\Processing\LocalCropScaleMaskHelper`
have been removed. Their functionality has been merged into
`\TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor`.

These helper classes existed for historical reasons and were never intended
to be part of the public API.

## Impact {#impact}

Any code that extends or references
`\TYPO3\CMS\Core\Resource\Processing\LocalPreviewHelper` or
`\TYPO3\CMS\Core\Resource\Processing\LocalCropScaleMaskHelper`
will now trigger PHP fatal errors.

## Affected installations {#affected-installations}

Installations with custom extensions that extend or reference either
`\TYPO3\CMS\Core\Resource\Processing\LocalPreviewHelper` or
`\TYPO3\CMS\Core\Resource\Processing\LocalCropScaleMaskHelper`
are affected and will cause PHP fatal errors.

These helper classes were meant to be internal but were never declared as
such. Implementations using them directly instead of the
`\TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor` should
be very rare.

## Migration {#migration}

Remove all references to
`\TYPO3\CMS\Core\Resource\Processing\LocalPreviewHelper` or
`\TYPO3\CMS\Core\Resource\Processing\LocalCropScaleMaskHelper`
from your code.

Use the
`\TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor`
directly instead, or implement a custom image processor that executes before
this processor to apply additional functionality.