---
title: "Deprecation: #82426 - typo3-pagetree navigation component name"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-82426"
source: "Changelog/9.0/Deprecation-82426-Typo3-pagetreeNavigationComponentName.rst"
typo3-version: "9.0"
typo3-major: 9
type: "deprecation"
issue: 82426
forge: "https://forge.typo3.org/issues/82426"
tags: ["Backend", "PHP-API", "PartiallyScanned"]
rendered: "2026-09-25T23:17:45+00:00"
---

# Deprecation: #82426 - typo3-pagetree navigation component name {#deprecation-82426}

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

## Description {#description}

When registering an extensions's BE module with `ExtensionUtility::registerModule()` it is possible to define 'navigationComponentId'.

The name the navigation component name `typo3-pagetree` has been marked as deprecated.
`TYPO3/CMS/Backend/PageTree/PageTreeElement` should be used instead.

## Impact {#impact}

Calling `ExtensionUtility::registerModule()` with the old navigation component name will trigger a deprecation log entry.

## Affected Installations {#affected-installations}

All installations having custom BE modules passing the old navigation component name to `ExtensionUtility::registerModule()`.

## Migration {#migration}

Use `TYPO3/CMS/Backend/PageTree/PageTreeElement` instead of `typo3-pagetree`.

### Old configuration: {#old-configuration}

```php
\TYPO3\CMS\Extbase\Utility\ExtensionUtility::registerModule(
    'TYPO3.CMS.Workspaces',
    'web',
    'workspaces',
    'before:info',
    [
        // An array holding the controller-action-combinations that are accessible
        'Review' => 'index,fullIndex,singleIndex',
        'Preview' => 'index,newPage'
    ],
    [
        'access' => 'user,group',
        'icon' => 'EXT:workspaces/Resources/Public/Icons/module-workspaces.svg',
        'labels' => 'LLL:EXT:workspaces/Resources/Private/Language/locallang_mod.xlf',
        'navigationComponentId' => 'typo3-pagetree'
    ]
);
```

### Should be changed to new configuration: {#should-be-changed-to-new-configuration}

```php
\TYPO3\CMS\Extbase\Utility\ExtensionUtility::registerModule(
    'TYPO3.CMS.Workspaces',
    'web',
    'workspaces',
    'before:info',
    [
        // An array holding the controller-action-combinations that are accessible
        'Review' => 'index,fullIndex,singleIndex',
        'Preview' => 'index,newPage'
    ],
    [
        'access' => 'user,group',
        'icon' => 'EXT:workspaces/Resources/Public/Icons/module-workspaces.svg',
        'labels' => 'LLL:EXT:workspaces/Resources/Private/Language/locallang_mod.xlf',
        'navigationComponentId' => 'TYPO3/CMS/Backend/PageTree/PageTreeElement'
    ]
);
```