---
title: "Breaking: #101603 - Removed hook for overriding icon overlay identifier"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:breaking-101603-1691322822"
source: "Changelog/13.0/Breaking-101603-RemovedHookForOverridingIconOverlayIdentifier.rst"
typo3-version: "13.0"
typo3-major: 13
type: "breaking"
issue: 101603
forge: "https://forge.typo3.org/issues/101603"
tags: ["Backend", "PHP-API", "FullyScanned", "ext:core"]
rendered: "2026-10-03T08:19:36+00:00"
---

# Breaking: #101603 - Removed hook for overriding icon overlay identifier {#breaking-101603-1691322822}

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

## Description {#description}

The hook `$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['TYPO3\CMS\Core\Imaging\IconFactory']['overrideIconOverlay']`
has been removed in favor of a new PSR-14 event `\TYPO3\CMS\Core\Imaging\Event\ModifyRecordOverlayIconIdentifierEvent`.

## Impact {#impact}

Any hook implementation registered is not executed anymore in TYPO3 v13.0+.

## Affected Installations {#affected-installations}

TYPO3 installations with custom extensions using this hook. The extension
scanner will report usages as strong match.

## Migration {#migration}

The hook is removed without deprecation in order to allow extensions
to work with TYPO3 v12 (using the hook) and v13+ (using the new event)
when implementing the event as well without any further deprecations.

Replace any hook usage with the new
[PSR-14 event](https://docs.typo3.org/permalink/changelog:feature-101603-1691322746).