---
title: "Deprecation: #101807 - ExtensionManagementUtility::addUserTSConfig()"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-101807-1693474000"
source: "Changelog/13.0/Deprecation-101807-ExtensionManagementUtilityaddUserTSConfig.rst"
typo3-version: "13.0"
typo3-major: 13
type: "deprecation"
issue: 101807
forge: "https://forge.typo3.org/issues/101807"
tags: ["LocalConfiguration", "PHP-API", "TSConfig", "FullyScanned", "ext:core"]
rendered: "2026-10-03T06:39:08+00:00"
---

# Deprecation: #101807 - ExtensionManagementUtility::addUserTSConfig() {#deprecation-101807-1693474000}

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

## Description {#description}

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.

## Impact {#impact}

Setting default user TSconfig using `ExtensionManagementUtility::addUserTSConfig()`
in `ext_localconf.php` files has been superseded by
[Automatic inclusion of user TSconfig of extensions](https://docs.typo3.org/permalink/changelog:feature-101807-1693473782). 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 {#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.

## Migration {#migration}

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.