---
title: "Feature: #98130 - Allow deprecation of icons in extensions"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-98130-1660295017"
source: "Changelog/12.0/Feature-98130-AllowDeprecationOfIconsInExtensions.rst"
typo3-version: "12.0"
typo3-major: 12
type: "feature"
issue: 98130
forge: "https://forge.typo3.org/issues/98130"
tags: ["Backend", "ext:core"]
rendered: "2026-09-25T23:17:45+00:00"
---

# Feature: #98130 - Allow deprecation of icons in extensions {#feature-98130-1660295017}

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

## Description {#description}

Extension authors are now able to deprecate icons if they are meant to be public
API. A new option `deprecated` is introduced that may contain the following
data:

-   `since` \- since when is the icon deprecated
-   `until` \- when will the icon be removed
-   `replacement` \- if given, an alternative icon is offered

## Impact {#impact}

An extension that provides icons for broader use is now able to mark such icons
as deprecated properly with logging to the TYPO3 deprecation log.

Example:

```php
// Configuration/Icons.php
return [
    'deprecated-icon' => [
        'provider' => \TYPO3\CMS\Core\Imaging\IconProvider\BitmapIconProvider::class,
        'source' => 'EXT:my_extension/Resources/Public/Icons/deprecated-icon.png',
        'deprecated' => [
            'since' => 'my extension v2',
            'until' => 'my extension v3',
            'replacement' => 'alternative-icon',
        ],
    ],
];
```