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 extensions ext_localconf.php has been deprecated in favour of the new service tag.

Additionally, the UpgradeWizardInterface, which all upgrade wizards must implement, does no longer require the getIdentifier() method. TYPO3 does not use this method anymore since an upgrade wizards 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 with TYPO3 v13.

Definition of the getIdentifier() method does no longer have any effect.

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'].


// ext_localconf.php

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install']['update']['myUpgradeWizard'] = \Vendor\Extension\Updates\MyUpgradeWizard::class;


// Classes/Updates/MyUpgradeWizard.php

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

class MyUpgradeWizard implements UpgradeWizardInterface


Drop any getIdentifier() method in custom upgrade wizards.