---
title: "Feature: #97454 - PSR-14 events for modifying link browser behavior"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-97454-1657327622"
source: "Changelog/12.0/Feature-97454-PSR14EventsForLinkBrowserLifecycle.rst"
typo3-version: "12.0"
typo3-major: 12
type: "feature"
issue: 97454
forge: "https://forge.typo3.org/issues/97454"
tags: ["Backend", "PHP-API", "ext:backend"]
rendered: "2026-09-20T18:31:11+00:00"
---

# Feature: #97454 - PSR-14 events for modifying link browser behavior {#feature-97454-1657327622}

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

## Description {#description}

Two new PSR-14 events `\TYPO3\CMS\Backend\Controller\Event\ModifyLinkHandlersEvent` and
`\TYPO3\CMS\Backend\Controller\Event\ModifyAllowedItemsEvent` have been introduced which
serve as a direct replacement for the now removed
`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['LinkBrowser']['hooks']`
[hooks](https://docs.typo3.org/permalink/changelog:breaking-97454-1657327622).

The `ModifyLinkHandlersEvent` is triggered before link handlers are
executed, allowing listeners to modify the set of handlers that will be used.
It is the direct replacement for the method `modifyLinkHandlers()` in the
LinkBrowser hook.

The `ModifyAllowedItemsEvent` can be used to dynamically modify the
allowed link types. It is the direct replacement for the method `modifyAllowedItems()`
in the LinkBrowser hook.

> [!NOTE]
> **See also**
>
> -   [Breaking: #97454 - Removed Link Browser hooks](https://docs.typo3.org/permalink/changelog:breaking-97454-1657327622)
> -   [Events to modify link handler](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/LinkHandling/Linkhandler/Events.html#modifyLinkHandlers)
> -   [ModifyLinkHandlersEvent](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/Events/Events/Backend/ModifyLinkHandlersEvent.html#ModifyLinkHandlersEvent)
> -   [ModifyAllowedItemsEvent](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/Events/Events/Backend/ModifyAllowedItemsEvent.html#ModifyAllowedItemsEvent)

## Example {#example}

Registration of the event in your extension's `Services.yaml`:

```yaml
MyVendor\MyPackage\MyEventListener:
  tags:
    - name: event.listener
      identifier: 'my-package/recordlist/link-handlers'
```

The corresponding event listener class:

```php
use TYPO3\CMS\Backend\Controller\Event\ModifyLinkHandlersEvent;

final class MyEventListener
{
    public function __invoke(ModifyLinkHandlersEvent $event): void
    {
        $handler = $event->getLinkHandler('url.');
        $handler['label'] = 'My custom label';
        $event->setLinkHandler('url.', $handler);
    }
}
```

## Impact {#impact}

It's now possible to modify link handlers behavior using the new PSR-14
`ModifyLinkHandlersEvent` and `ModifyAllowedItemsEvent`.