Attention

TYPO3 v12 has reached end-of-life as of April 30th 2026 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v12 here: TYPO3 ELTS.

Localization of Extbase models

Identifiers in localized models

Domain models have a main identifier uid and an additional property _localizedUid.

Depending on whether the overlay type language aspect is enabled (LanguageAspect::OVERLAYS_ON or LanguageAspect::OVERLAYS_MIXED) or disabled (LanguageAspect::OVERLAYS_OFF), the identifier contains different values.

When the overlay language aspect is enabled, then the uid property contains the uid value of the default language record and the uid of the translated record is kept in the _localizedUid.

Context	Record in language 0	Translated record
Database	uid:2	uid:11, l10n_parent:2
Domain object values with Overlay language aspect enabled	uid:2, _localizedUid:2	uid:2, _localizedUid:11
Domain object values with Overlay language aspect disabled	uid:2, _localizedUid:2	uid:11, _localizedUid:11

Hint

If your project uses typo3/cms-workspaces there is yet another additional property, _versionedUid. Refer to the Workspaces documentation for details on workspace overlays.