Attention

TYPO3 v11 has reached end-of-life as of October 31th 2024 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v10 here: TYPO3 ELTS.

searchFields

searchFields

Type: string
Path: $GLOBALS['TCA'][$table]['ctrl']
Scope: Search

Comma-separated list of fields from the table that will be included when searching for records in the TYPO3 backend. No record from a table will ever be found if that table does not have searchFields defined. Only fields of the following TCA types are searchable:

Adding fields of different types to searchFields has no effect.

There are more fine grained controls per column, see the documentation of the "search" key of any type in Field types (config > type).

Note

Fields of type input may be excluded from search by default, especially when using date, time or int in eval. To include them, modify the search query with this hook: Feature: #71911 - Add constraint hook in DatabaseRecordList->makeSearchString.

Note

When searching as admin the fields uid and pid are automatically included. For editors, uid and/or pid have to be added manually to the searchFields list.

Examples

Example from "tt_content" table:

'ctrl' => [
   'searchFields' => 'header,header_link,subheader,bodytext,pi_flexform',
   ...
],