---
title: "Feature: #99739 - Associative array keys for TCA items"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-99739-1674867455"
source: "Changelog/12.3/Feature-99739-AssociativeArrayKeysForTCAItems.rst"
modified: "2026-09-15T10:46:36+00:00"
---

# Feature: #99739 - Associative array keys for TCA items

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

## Description

It is now possible to define associative array keys for the `items`
configuration of TCA types `select`, `radio` and `check`. The
new keys are called: `label`, `value`, `icon`, `group` and
`description`.

Examples:

```php
'columns' => [
    'select' => [
        'label' => 'My select field',
        'config' => [
            'type' => 'select',
            'renderType' => 'selectSingle',
            'items' => [
                [
                    'label' => 'Selection 1',
                    'value' => '1',
                    'icon' => 'my-icon-identifier',
                    'group' => 'default',
                ],
                [
                    'label' => 'Selection 2',
                    'value' => '2',
                ],
            ],
        ],
    ],
    'select_checkbox' => [
        'label' => 'My select checkbox field',
        'config' => [
            'type' => 'select',
            'renderType' => 'selectCheckBox',
            'items' => [
                [
                    'label' => 'My select checkbox field',
                    'value' => '1',
                    'icon' => 'my-icon-identifier',
                    'group' => 'default',
                    'description' => 'My custom description',
                ],
                [
                    'label' => 'My select checkbox field',
                    'value' => '2',
                ],
            ],
        ],
    ],
    'radio' => [
        'label' => 'My radio field',
        'config' => [
            'type' => 'radio',
            'items' => [
                [
                    'label' => 'Radio 1',
                    'value' => '1',
                ],
                [
                    'label' => 'Radio 2',
                    'value' => '2',
                ],
            ],
        ],
    ],
    'check' => [
        'config' => [
            'type' => 'check',
            'items' => [
                [
                    'invertStateDisplay' => true,
                    'label' => 'Click on me',
                ],
            ],
        ],
    ],
],
```

## Impact

It is now much easier and clearer to define the TCA `items` configuration
with associative array keys. The struggle to remember which option is first,
label or value, is now over. In addition, optional keys like `icon` and
`group` can be omitted, for example, when one desires to set the
`description` option.