---
title: "Deprecation: #85980 - @internal annotation in extbase commands"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-85980"
source: "Changelog/9.5/Deprecation-85980-InternalAnnotationInExtbaseCommands.rst"
modified: "2026-09-15T10:46:36+00:00"
---

# Deprecation: #85980 - @internal annotation in extbase commands

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

## Description

The `@internal` annotation has been marked as deprecated and will be removed from TYPO3 v10
without any replacement.

This is a regular phpDocumentor annotation that is used to denote that associated structural
elements are elements internal to the application or library. It has been misused by Extbase to tell
if a command is internal and thus should not be exposed through help texts, user documentation etc.

TYPO3 does no longer support the use of the `@internal` annotation to influence the behaviour
of the code.

## Impact

Using `@internal` on methods of classes extending
`\TYPO3\CMS\Extbase\Mvc\Controller\CommandController` will trigger a PHP `E_USER_DEPRECATED` error.

## Affected Installations

All installations that make use of Extbase commands whose methods are tagged with `@internal`.

## Migration

Just remove the annotation from the affected controllers.