Feature: #98130 - Allow deprecation of icons in extensions

See forge#98130


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


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.


// 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',