---
title: "Feature: #82213 - New hook to determine if content record is used/unused"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-82213"
source: "Changelog/9.0/Feature-82213-NewHookToDetermineIfContentRecordIsUsedUnused.rst"
typo3-version: "9.0"
typo3-major: 9
type: "feature"
issue: 82213
forge: "https://forge.typo3.org/issues/82213"
tags: ["Backend", "PHP-API"]
rendered: "2026-09-17T12:41:04+00:00"
---

# Feature: #82213 - New hook to determine if content record is used/unused {#feature-82213-new-hook-to-determine-if-content-record-is-used-unused}

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

## Description {#description}

A new hook has been added to the `PageLayoutView` class, determining whether a
content record is used or not. The hook allows third party code to change the
`$used` parameter by returning a boolean, thus changing which content records
are shown in the "unused content elements" section of the backend page module.

## Impact {#impact}

Without providing an own hook, content elements with an colPos not defined within
the current backend layout are marked as unused. You have to register and provide
an own PHP class checking if an content record is used within your configuration.

```php
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['cms/layout/class.tx_cms_layout.php']['record_is_used']['myExt'] =
MyExt\MyExt\Hooks\PageLayoutViewHook::class . '->contentIsUsed';
```

```php
namespace MyExt\MyExt\Hooks;

use TYPO3\CMS\Backend\View\PageLayoutView;

class PageLayoutViewHook
{
    public function contentIsUsed(array $params, PageLayoutView $parentObject): bool
    {
        if ($params['used']) {
           return true;
        }
        $record = $params['record'];
        return $record['colPos'] === 999 && !empty($record['tx_myext_content_parent']);
    }
}
```
