---
title: "Breaking: #97188 - Register element browsers via service configuration"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:breaking-97188"
source: "Changelog/12.0/Breaking-97188-RegisterElementBrowsersViaServiceConfiguration.rst"
typo3-version: "12.0"
typo3-major: 12
type: "breaking"
issue: 97188
forge: "https://forge.typo3.org/issues/97188"
tags: ["Backend", "LocalConfiguration", "PHP-API", "FullyScanned", "ext:backend"]
rendered: "2026-09-28T19:48:07+00:00"
---

# Breaking: #97188 - Register element browsers via service configuration {#breaking-97188}

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

## Description {#description}

The `element browsers` in EXT:backend are now registered via service
configuration, see the [feature changelog](https://docs.typo3.org/permalink/changelog:feature-97188).
Therefore the registration via
`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ElementBrowsers']`
has been removed.

Additionally, to be able to use autoconfiguration, the `element browser`
identifier has to be provided by the service directly using the
`getIdentifier()` method, which is now required by the
`ElementBrowserInterface`.

In case a custom `element browser` extends
`\TYPO3\CMS\Backend\ElementBrowser\AbstractElementBrowser`,
only the class property `$identifier` has to be set, e.g.
`protected string $identifier = 'my_browser';`.

## Impact {#impact}

Registration of custom `element browsers` via
`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ElementBrowsers']`
is not evaluated anymore.

The `ElementBrowserInterface` is extended for
`public function getIdentifier(): string`.

## Affected Installations {#affected-installations}

All TYPO3 installations using the old registration.

All TYPO3 installations with custom `element browsers`, not implementing
`public function getIdentifier()`.

## Migration {#migration}

Remove `$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ElementBrowsers']`
from your `ext_localconf.php` file.

If `autoconfigure` is not enabled in your `Configuration/Services.(yaml|php)`,
add the tag `recordlist.elementbrowser` manually to your `element browser` service.

```yaml
Vendor\Extension\Recordlist\MyBrowser:
  tags:
    - name: recordlist.elementbrowser
```

Additionally, make sure to either implement
`public function getIdentifier(): string` or, in case your `element browser`
extends `AbstractElementBrowser`, to set the `$identifier` class property.