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.

label

label

Type: string (field name)
Path: $GLOBALS['TCA'][$table]['ctrl']
Scope: Display

Required!

Points to the field name of the table which should be used as the "title" when the record is displayed in the system.

Note

label_userFunc overrides this property (but it is still required).

Warning

For the label only regular input or text fields should be used. Otherwise issues may occur and prevent from a working system if TCEMAIN.table.tt_content.disablePrependAtCopy is not set or set to 0.

A simple example

A minimal example of the control section

EXT:styleguide/Configuration/TCA/tx_styleguide_ctrl_minimal.php

[
    'ctrl' => [
        'title' => 'LLL:EXT:styleguide/Resources/Private/Language/locallang.xlf:minimalTableTitle',
        'label' => 'title',
        'iconfile' => 'EXT:styleguide/Resources/Public/Icons/tx_styleguide.svg',
    ],
    'columns' => [
        'title' => [
            'label' => 'LLL:EXT:styleguide/Resources/Private/Language/locallang.xlf:minimalTableTitleField',
            'config' => [
                'type' => 'input',
            ],
        ],
    ],
    'types' => [
        [
            'showitem' => 'title',
        ],
    ],
]

label_alt

label_alt

Type: String (comma-separated list of field names)
Scope: Display

Comma-separated list of field names, which are holding alternative values to the value from the field pointed to by "label" (see above) if that value is empty. May not be used consistently in the system, but should apply in most cases.

Note

label_userFunc overrides this property, also see label_alt_force.

Examples

Example for table "tt_content":

'ctrl' => [
   'label' => 'header',
   'label_alt' => 'subheader,bodytext',
],

label_alt_force

label_alt_force

Type: boolean
Scope: Display

If set, then the label field and the label_alt fields are shown in the title separated by comma.

Note

label_userFunc overrides this property.