searchFields

searchFields

Path

$GLOBALS['TCA'][$table]['ctrl']

Type

string

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:

• input

• text

• flex

• email

• link

• slug

• color

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 number or datetime may be excluded from search by default. 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',
   ...
],