---
title: "Feature: #72505 - Introduce hook to override a record overlay"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-72505-1668719172"
source: "Changelog/8.0/Feature-72505-IntroduceHookToOverrideARecordOverlay.rst"
modified: "2026-09-14T09:47:36+00:00"
---

# Feature: #72505 - Introduce hook to override a record overlay

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

## Description

Prior to TYPO3 7 LTS, it was possible to override a record overlay in Web > List.
This patch introduces a new hook with the old functionality.

The hook is called with the following signature:

```php
/**
 * @param string $table
 * @param array $row
 * @param array $status
 * @param string $iconName
 * @return string the new (or given) $iconName
 */
function postOverlayPriorityLookup($table, array $row, array $status, $iconName)
```

### Register the hook

Register the hook class which implements the method with the name `postOverlayPriorityLookup`:

```php
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS'][IconFactory::class]['overrideIconOverlay'][] = \VENDOR\MyExt\Hooks\IconFactoryHook::class;
```