---
title: "Feature: #94406 - Override fileFolder TCA configuration with TSconfig"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-94406"
source: "Changelog/11.4/Feature-94406-OverrideFileFolderTCAConfigurationWithTSconfig.rst"
typo3-version: "11.4"
typo3-major: 11
type: "feature"
issue: 94406
forge: "https://forge.typo3.org/issues/94406"
tags: ["Backend", "TCA", "TSConfig", "ext:backend"]
rendered: "2026-09-19T12:12:50+00:00"
---

# Feature: #94406 - Override fileFolder TCA configuration with TSconfig {#feature-94406}

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

## Description {#description}

The special [fileFolder configuration options](https://docs.typo3.org/m/typo3/reference-tca/main/en-us/ColumnsConfig/Type/Select/Properties/FileFolder.html#filefolder)
for TCA columns of type `select` can be used to fill a select field with files
(images / icons) from a defined folder. This is really handy, e.g. for selecting
predefined icons from a corporate icon set. However, in installations with
multiple sites, such icon sets usually differ from site to site.

Therefore, the `fileFolder` configuration can now be overridden with page
TSconfig, allowing administrators to easily handle those situations by e.g.
using different folders or allowing different file extensions, per site.

To streamline both, the TCA configuration and the corresponding overrides,
the `fileFolder` configuration options have been moved into a dedicated sub
array `fileFolderConfig`, some options have been renamed:

-   `fileFolder` option `folder`
-   `fileFolder_extList` to `allowedExtensions`
-   `fileFolder_recursions` to `depth`

A TCA migration wizard is available, showing where adjustments have to take place.

Before:

```php
'aField' => [
   'config' => [
      'type' => 'select',
      'renderType' => 'selectSingle',
      'fileFolder' => 'EXT:my_ext/Resources/Public/Icons',
      'fileFolder_extList' => 'svg',
      'fileFolder_recursions' => 1,
   ]
]
```

After:

```php
'aField' => [
   'config' => [
      'type' => 'select',
      'renderType' => 'selectSingle',
      'fileFolderConfig' => [
         'folder' => 'EXT:styleguide/Resources/Public/Icons',
         'allowedExtensions' => 'svg',
         'depth' => 1,
      ]
   ]
]
```

Thus, the following TSconfig options can be used to overriding their
TCA counterpart:

```typoscript
config.fileFolderConfig.folder
config.fileFolderConfig.allowedExtensions
config.fileFolderConfig.depth
```

As already known from TCEFORM, those options can be used on various levels

On table level:

```typoscript
TCEFORM.myTable.myField.config.fileFolderConfig.folder
```

On table and record type level:

```typoscript
TCEFORM.myTable.myFiled.types.myType.config.fileFolderConfig.folder
```

On flex form field level:

```typoscript
TCEFORM.myTable.pi_flexform.my_ext_pi1.sDEF.myField.config.fileFolderConfig.folder
```

> [!NOTE]
> Except `config.fileFolderConfig.folder`, the new options can not
> only be used to override an existing property, but also to define
> one, which has not yet been configured in TCA.

## Impact {#impact}

It's now possible to override the TCA `fileFolder` configuration options
with page TSconfig, allowing administrators to manipulate the available
items on a page basis.

The `fileFolder` TCA configuration is furthermore streamlined and now
encapsulated in a dedicated sub array `fileFolderConfig`.