---
title: "Breaking: #69561 - Replace sprite icons with IconFactory in ContextMenu"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:breaking-69561"
source: "Changelog/7.5/Breaking-69561-ReplaceSpriteIconsWithIconFactoryInContextMenu.rst"
typo3-version: "7.5"
typo3-major: 7
type: "breaking"
issue: 69561
forge: "https://forge.typo3.org/issues/69561"
tags: ["PHP-API", "TSConfig", "Backend"]
rendered: "2026-09-17T21:17:42+00:00"
---

# Breaking: #69561 - Replace sprite icons with IconFactory in ContextMenu {#breaking-69561-replace-sprite-icons-with-iconfactory-in-contextmenu}

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

## Description {#description}

SpriteIcon and standalone image support have been replaced with `IconFactory` in
the context menu. All menu icons now need to be registered through the `IconRegistry`.

## Impact {#impact}

The `UserTsConfig` options for items `icon` and `spriteIcon` have no effect anymore,
and will deliver a blank placeholder image if `iconName` is not set.

## Affected Installations {#affected-installations}

All installations that add or modify items in the ContextMenu.

## Migration {#migration}

Register the icon through the `IconRegistry` and set the `iconName` in the
item configuration.

```php
// Register Icon
$iconRegistry = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(\TYPO3\CMS\Core\Imaging\IconRegistry::class);
$iconRegistry->registerIcon(
	'contextmenu-example',
	\TYPO3\CMS\Core\Imaging\IconProvider\SvgIconProvider::class,
	array(
		'source' => 'EXT:example/Resources/Public/Icons/contextmenu-example.svg'
	))
);
```

```typoscript
options.contextMenu.table {
	virtual_root.items {
		9999 = ITEM
		9999 {
			name = contextmenuExample
			label = LLL:EXT:example/Resources/Private/Language/locallang.xlf:contextmenu-example
			iconName = contextmenu-example
			callbackAction = exampleCallback
		}
	}
}
```