#111413Deprecate language key "default" in TypoScript _LOCAL_LANG
Description
The source labels of all language files (XLIFF files without language prefix, e.g. locallang.xlf) are English. Their language code is “en”, like “de” or “fr” for translations. The language key “default” is only a historical alias for these source labels and should be phased out of all places where integrators and extension authors define languages. Backend users (#108783) and the preferred browser language detection already use “en”.
This task covers the user-land side:
- Deprecate TypoScript
_LOCAL_LANG.defaultin favour of_LOCAL_LANG.en. Labels for “en” override labels for English and additionally act as last-resort fallback for all other languages (the role “default” had so far). “default” keeps working until v16.0 and triggers a deprecation. - Treat the site language setting
typo3Language: default(deprecated since v12.3) as “en”. - EXT:form email finishers offer and store “en” instead of “default” as translation language.
- Styleguide generates sites with typo3Language “en”.
- Remove the obsolete “default” check in ResetPasswordController, as Locales::getPreferredClientLanguage() never returns “default” anymore.
The internal use of “default” (loading the base label files under the “default” key in LocalizationFactory, LabelFileResolver, LanguageService, lowlevel) will be handled in a separate task. Removing the “default” to “en” mapping in Locale is planned for v16.
Reviews 1
History 01
-
Gerrit Code Review pushed patch set 1 for main to change 97550 status
NewUnder Review <span data-processor="relativetime" data-value="2026-11-11T15:39:39+00:00" > 11/11/26, 15:39 </span>