Deprecation: #99586 - Registration of upgrade wizards via $GLOBALS

See forge#99586


Registration of upgrade wizards via $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update'], usually placed in an extension's ext_localconf.php has been deprecated in favor of the new service tag.

Additionally, the \TYPO3\CMS\Install\Updates\UpgradeWizardInterface, which all upgrade wizards must implement, does no longer require the getIdentifier() method. TYPO3 does not use this method anymore since an upgrade wizard's identifier is now defined using the new service tag.


Upgrade wizards, registered via $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update'] will no longer be recognized in TYPO3 v13.

The definition of the getIdentifier() method has no effect anymore.

Affected installations

All installations registering custom upgrade wizards using $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update'].

All installations implementing the getIdentifier() method in their upgrade wizards.


Use the new service tag to register custom upgrade wizards and remove the registration via $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update'].


    = \MyVendor\MyExtension\Updates\MyUpgradeWizard::class;


namespace MyVendor\MyExtension\Updates;

use TYPO3\CMS\Install\Attribute\UpgradeWizard;
use TYPO3\CMS\Install\Updates\UpgradeWizardInterface;

class MyUpgradeWizard implements UpgradeWizardInterface


Drop any getIdentifier() method in custom upgrade wizards.