---
title: "Deprecation: #111326 - LanguageAspect::OVERLAYS_ON"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-111326-1793692850"
source: "Changelog/15.0/Deprecation-111326-LanguageAspectOverlaysOn.rst"
typo3-version: "15.0"
typo3-major: 15
type: "deprecation"
issue: 111326
forge: "https://forge.typo3.org/issues/111326"
tags: ["PHP-API", "FullyScanned", "ext:core"]
rendered: "2026-11-14T17:17:53+00:00"
---

# Deprecation: #111326 - LanguageAspect::OVERLAYS_ON {#deprecation-111326-1793692850}

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

## Description {#description}

The overlay type `\TYPO3\CMS\Core\Context\LanguageAspect::OVERLAYS_ON`
(value `'on'`) has been marked as deprecated and will be removed in
TYPO3 v16.0.

This overlay type is never created from a site configuration:
`fallbackType: strict` results in
`LanguageAspect::OVERLAYS_ON_WITH_FLOATING`,
`fallbackType: fallback` in `LanguageAspect::OVERLAYS_MIXED` and
`fallbackType: free` in `LanguageAspect::OVERLAYS_OFF`. It is only
used when a `\TYPO3\CMS\Core\Context\LanguageAspect` is created
manually.

The record overlay in
`\TYPO3\CMS\Core\Domain\Repository\PageRepository` already treats
both overlay types the same way. The only difference is how records of the
requested language without a record in the default language ("floating"
records) are handled: with `LanguageAspect::OVERLAYS_ON`, the TypoScript
content object `CONTENT` and Extbase repositories do not include
them. Removing this overlay type reduces the number of language overlay modes
that need to be considered.

## Impact {#impact}

Creating a `\TYPO3\CMS\Core\Context\LanguageAspect` with the overlay
type `'on'` triggers a PHP deprecation warning. The behavior stays the
same until the overlay type is removed in TYPO3 v16.0.

## Affected installations {#affected-installations}

TYPO3 installations with custom extensions that create a
`\TYPO3\CMS\Core\Context\LanguageAspect` with
`LanguageAspect::OVERLAYS_ON` or the value `'on'`, for example to set
a custom language aspect on Extbase query settings or in the context.

The extension scanner reports usages of the constant as a **strong match**.

## Migration {#migration}

Use `LanguageAspect::OVERLAYS_ON_WITH_FLOATING` instead. This is the
overlay type that is used by sites with `fallbackType: strict`.

Records of the requested language without a record in the default language are
then included in the result. If they must not be shown, exclude them in the
query. For the content object `CONTENT`, set the option
`select.includeRecordsWithoutDefaultTranslation = 0`.

**Before (deprecated)**

```php
use TYPO3\CMS\Core\Context\LanguageAspect;

$languageAspect = new LanguageAspect(1, 1, LanguageAspect::OVERLAYS_ON);
```

**After**

```php
use TYPO3\CMS\Core\Context\LanguageAspect;

$languageAspect = new LanguageAspect(1, 1, LanguageAspect::OVERLAYS_ON_WITH_FLOATING);
```
