---
title: "Deprecation: #109412 - TypoScript-based form YAML registration"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:deprecation-109412-1742000001"
source: "Changelog/14.2/Deprecation-109412-FormYamlConfigurationRegistration.rst"
typo3-version: "14.2"
typo3-major: 14
type: "deprecation"
issue: 109412
forge: "https://forge.typo3.org/issues/109412"
tags: ["YAML", "Frontend", "Backend", "FullyScanned", "ext:form"]
rendered: "2026-09-20T18:31:11+00:00"
---

# Deprecation: #109412 - TypoScript-based form YAML registration {#deprecation-109412-1742000001}

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

## Description {#description}

The TypoScript-based registration of form YAML configuration files via
`plugin.tx_form.settings.yamlConfigurations` and
`module.tx_form.settings.yamlConfigurations` has been
deprecated in favor of the new auto-discovery mechanism introduced in
TYPO3 v14.2 (see [Feature-109412](https://docs.typo3.org/permalink/changelog:feature-109412-1742000001)).

Before TYPO3 v14.2 this was the only way to register `EXT:form` YAML files. It
required separate registration of the frontend and the backend
in TypoScript:

**EXT:my_extension/Configuration/TypoScript/setup.typoscript — deprecated**

```typoscript
plugin.tx_form.settings.yamlConfigurations {
    1732785702 = EXT:my_extension/Configuration/Form/MySetup.yaml
}

# Backend had to be registered separately:
module.tx_form.settings.yamlConfigurations {
    1732785703 = EXT:my_extension/Configuration/Form/MySetup.yaml
}
```

The TypoScript-based paths will still be loaded during the deprecation
period but will be removed in TYPO3 v15.0.

## Impact {#impact}

Extensions that register form YAML files via TypoScript will trigger a
PHP `E_USER_DEPRECATED` error. The registered YAML files are still
loaded and will remain functional during the deprecation period.

## Affected installations {#affected-installations}

All installations where an extension registers form YAML files via:

-   `plugin.tx_form.settings.yamlConfigurations`
-   `module.tx_form.settings.yamlConfigurations`

## Migration {#migration}

Replace TypoScript registration with the auto-discovery directory
convention introduced in TYPO3 v14.2
(see [Feature-109412](https://docs.typo3.org/permalink/changelog:feature-109412-1742000001)).

1.  Create directory `EXT:my_extension/Configuration/Form/MySet/`.
1.  Add a `config.yaml` file with a unique `name` and, optionally,
    a `priority` value (default: 100; the core base set is
    priority 10):

    **EXT:my_extension/Configuration/Form/MySet/config.yaml**

    ```yaml
    name: my-vendor/my-form-set
    label: 'My Custom Form Set'
    priority: 200
    ```
1.  Add your existing form configuration to `config.yaml` below
    the metadata keys:

    **EXT:my_extension/Configuration/Form/MySet/config.yaml**

    ```yaml
    name: my-vendor/my-form-set
    label: 'My Custom Form Set'
    priority: 200

    # Content of your former MySetup.yaml
    persistenceManager:
      allowedExtensionPaths:
        10: 'EXT:my_extension/Resources/Private/Forms/'
    ```
1.  Remove TypoScript registrations from
    `setup.typoscript`. PHP or TypoScript registration is
    no longer necessary.

The YAML files are picked up automatically for **both** frontend and
backend without any additional registration.