---
title: "Breaking: #69057 - Deprecate IconUtility and move methods into IconFactory"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:breaking-69057"
source: "Changelog/7.5/Breaking-69057-DeprecateIconUtilityAndMoveMethodsIntoIconFactory.rst"
typo3-version: "7.5"
typo3-major: 7
type: "breaking"
issue: 69057
forge: "https://forge.typo3.org/issues/69057"
tags: ["PHP-API", "Backend"]
rendered: "2026-09-19T12:12:50+00:00"
---

# Breaking: #69057 - Deprecate IconUtility and move methods into IconFactory {#breaking-69057}

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

## Description {#description}

While refactoring the `IconUtility` to the new `IconFactory` class, several methods have been marked as deprecated.
In some cases parameters of the old `IconUtility` methods are not used anymore.
The following list describes the possible breaking changes.

The second parameter `$options` of method `IconUtility::getSpriteIconForFile()` is not used anymore.
The third parameter `$options` of method `IconUtility::getSpriteIconForRecord()` is not used anymore.

The `IconUtility` signals `buildSpriteIconClasses` and `buildSpriteHtmlIconTag` have been dropped and will not be emitted anymore.
The `IconUtility` hook `$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_iconworks.php']['overrideIconOverlay']` has been dropped and will not be called anymore.

## Impact {#impact}

Extensions could break if the methods, signals or hooks above are used.

## Affected Installations {#affected-installations}

Extensions that call the methods with the `$options` parameter or make use of the signals and hook.

## Migration {#migration}

Make use of the new `IconFactory` class.