Deprecation: #101807 - ExtensionManagementUtility::addUserTSConfig()

See forge#101807


The method \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addUserTSConfig() has been marked as deprecated in TYPO3 v13 and will be removed with TYPO3 v14.

The global configuration option $GLOBALS['TYPO3_CONF_VARS']['BE']['defaultUserTSconfig'] has been marked as deprecated in TYPO3 v13, will be ignored and removed from instance configuration files as silent upgrade with TYPO3 v14.


Setting default user TSconfig using ExtensionManagementUtility::addUserTSConfig() in ext_localconf.php files has been superseded by Automatic inclusion of user TSconfig of extensions. The old way has been deprecated, extensions should switch to the new functionality by placing default user TSconfig in Configuration/user.tsconfig files.

Affected installations

Instances with extensions using ExtensionManagementUtility::addUserTSConfig() or directly extending $GLOBALS['TYPO3_CONF_VARS']['BE']['defaultUserTSconfig'] are affected: Using ExtensionManagementUtility::addUserTSConfig() triggers a deprecation level log message. The extension scanner will find usages of ExtensionManagementUtility::addUserTSConfig() as strong match.


Add default user TSconfig to a Configuration/user.tsconfig file within an extension and remove calls to ExtensionManagementUtility::addUserTSConfig().

Extensions with compatibility for both TYPO3 v12 and v13 should keep the old way and switch to the new way when v12 support is dropped.