---
title: "Deprecation: #85892 - Various methods regarding sys_domain-resolving"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-85892"
source: "Changelog/9.4/Deprecation-85892-VariousMethodsRegardingSysDomainResolving.rst"
modified: "2026-09-15T10:46:36+00:00"
---

# Deprecation: #85892 - Various methods regarding sys_domain-resolving

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

## Description

Various methods specific for handling `sys_domain` records have been marked as deprecated. As the new site handling is in place in favor of using `sys_domain`
records, these methods have been centralized in a `LegacyDomainResolver` class, which is however marked as internal.

Instead, generating URLs should be done via the new PageUriBuilder and Routing API, which covers both the new
site handling and the specific sys_domain record.

The following methods have been marked as deprecated:

-   `TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController->domainNameMatchesCurrentRequest()`
-   `TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController->getDomainDataForPid()`
-   `TYPO3\CMS\Backend\Utility\BackendUtility::getDomainStartPage()`
-   `TYPO3\CMS\Backend\Utility\BackendUtility::firstDomainRecord()`

## Impact

Calling any of the methods will trigger a PHP `E_USER_DEPRECATED` error.

## Affected Installations

Any installation with custom functionality regarding `sys_domain` handling where any of the methods mentioned above are used.

## Migration

Migrate to either the new Routing API (finalized for 9 LTS) or implement the functionality in your own, or use the `LegacyDomainResolver` class,
but since the concept of sys_domain handling will be removed in TYPO3 v10, consider use of the Site handling functionality instead.
