---
title: "Breaking: #106972 - TCA control option searchFields removed"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:breaking-106972-1750856858"
source: "Changelog/14.0/Breaking-106972-TCAControlOptionSearchFieldsRemoved.rst"
typo3-version: "14.0"
typo3-major: 14
type: "breaking"
issue: 106972
forge: "https://forge.typo3.org/issues/106972"
tags: ["TCA", "FullyScanned", "ext:core"]
rendered: "2026-09-23T15:30:34+00:00"
---

# Breaking: #106972 - TCA control option searchFields removed {#breaking-106972-1750856858}

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

## Description {#description}

The TCA control option `$GLOBALS['TCA'][$table]['ctrl']['searchFields']`
has been removed.

With the introduction of the Schema API and the
`\TYPO3\CMS\Core\Schema\SearchableSchemaFieldsCollector` component,
the handling of fields included in searches has changed. By default, all
fields of suitable types, such as `input` or `text`, are now automatically
considered searchable.

To manually define searchable fields, use the new `searchable` field
configuration option within a field's TCA configuration.
See the full list of supported field types
[here](https://docs.typo3.org/permalink/changelog:feature-106972-1750856721).
Unsupported field types (such as `file`, `inline`, etc.) are not considered
searchable and do not support the `searchable` option.

> [!NOTE]
> This change does not affect the Page TSconfig option used by
> EXT:linkvalidator: `mod.linkvalidator.searchFields`.

## Impact {#impact}

The `searchFields` option is no longer evaluated. It is automatically
removed at runtime through a TCA migration, and a deprecation log entry is
generated to highlight where adjustments are required.

If [suitable](https://docs.typo3.org/permalink/changelog:feature-106972-1750856721) fields are detected that were
not listed in the removed `searchFields` option, they are automatically
set to `searchable => false` to preserve previous behavior.

## Affected installations {#affected-installations}

All installations that define `searchFields` in their TCA configuration.

## Migration {#migration}

Remove the `searchFields` option from the `ctrl` section of your TCA
configuration.

If needed, use the `searchable` option in individual field definitions
to control which fields are included in the search functionality.