---
title: "Deprecation: #107068 - Rename fieldExplanationText to description"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-107068-1759214357"
source: "Changelog/14.2/Deprecation-107068-RenameFieldExplanationTextToDescription.rst"
typo3-version: "14.2"
typo3-major: 14
type: "deprecation"
issue: 107068
forge: "https://forge.typo3.org/issues/107068"
tags: ["Backend", "ext:form", "NotScanned"]
rendered: "2026-09-20T18:31:11+00:00"
---

# Deprecation: #107068 - Rename fieldExplanationText to description {#deprecation-107068-1759214357}

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

## Description {#description}

The configuration option `fieldExplanationText` has been deprecated
in favor of `description`. The new name better reflects its purpose
and is easier to understand.

This affects form element type definitions in
`prototypes.*.formElementsDefinition.*.formEditor` configuration,
including editors, validators, and finishers in any extension.

## Impact {#impact}

Using `fieldExplanationText` will trigger a PHP deprecation warning.
The migration service will automatically convert `fieldExplanationText`
to `description` when form configuration is loaded, ensuring
backward compatibility.

Support for `fieldExplanationText` will be removed in TYPO3 v15.0.

## Affected installations {#affected-installations}

Any installations with extensions that provide custom form element type
definitions with the configuration option `fieldExplanationText`
in their form prototype YAML files (e.g., `Configuration/Form/*.yaml`
or `Configuration/Yaml/FormSetup.yaml`).

## Migration {#migration}

Rename any occurrence of `fieldExplanationText` to `description`
in your form element type definition YAML files (typically located in
`Configuration/Yaml/FormElements/*.yaml`).

Example migration:

```diff
# After
formEditor:
  editors:
    200:
      identifier: placeholder
      label: Placeholder
-     fieldExplanationText: Enter the placeholder text
+     description: Enter the placeholder text
```