:navigation-title: TCA

..  include:: /Includes.rst.txt
..  _configuration-tca:

===============================
Table Configuration Array (TCA)
===============================

Set the `renderType` of a
`single-select <https://docs.typo3.org/permalink/t3tca:columns-select-rendertype-selectsingle>`_
to `icon` in order to make icons selectable by backend users. All
configuration options for a standard single-select field can be applied.

..  figure:: /Images/IconSelect.png
    :class: with-shadow

    The backend icon selector

..  code-block:: php
    :caption: EXT:my_ext/Configuration/TCA/tx_myext_elements_icon.php

    [
        'columns' => [
            'icon_select' => [
                'label' => 'Icon selector',
                'config' => [
                    'type' => 'select',
                    'renderType' => 'icon',
                    'items' => [
                        ['label' => 'Choose icon…', 'value' => '']
                    ],
                    'itemGroups' => [
                        'icomoon' => 'Icomoon'
                    ]
                ]
            ]
        ]
    ]