---
title: "Feature: #81363 - EXT:form - support form element translation arguments"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:feature-81363"
source: "Changelog/9.0/Feature-81363-AcceptFormElementTranslationArguments.rst"
typo3-version: "9.0"
typo3-major: 9
type: "feature"
issue: 81363
forge: "https://forge.typo3.org/issues/81363"
tags: ["Frontend", "TypoScript", "ext:form"]
rendered: "2026-09-17T21:17:42+00:00"
---

# Feature: #81363 - EXT:form - support form element translation arguments {#feature-81363-ext-form-support-form-element-translation-arguments}

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

## Description {#description}

Passing arguments to form element property translations is now supported to enrich
translations with variable values.

This works for simple, static values purely in YAML:

```yaml
renderables:
  fieldWithTranslationArguments:
    identifier: field-with-translation-arguments
    type: Checkbox
    label: This is a %s feature
    renderingOptions:
      translation:
        translationFile: path/to/locallang.xlf
        arguments:
          label:
            - useful
```

Alternatively, translation arguments can be set via `formDefinitionOverrides`
in TypoScript. A common usecase is a checkbox for user confirmation linking to details of
the topic:

```yaml
renderables:
  fieldWithTranslationArguments:
    identifier: field-with-translation-arguments
    type: Checkbox
    label: I agree to the <a href="%s">terms and conditions</a>
    renderingOptions:
      translation:
        translationFile: path/to/locallang.xlf
```

```typoscript
plugin.tx_form {
  settings {
    formDefinitionOverrides {
      <form-id> {
        renderables {
          0 { # Page
            renderables {
              fieldWithTranslationArguments {
                renderingOptions {
                  translation {
                    arguments {
                      label {
                        0 = TEXT
                        0.typolink {
                          # Terms and conditions page, could be set also via TypoScript constants
                          parameter = 42
                          returnLast = url
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```

> [!IMPORTANT]
> There must be at least one translation file with a translation for the configured form element property. Arguments are not inserted into default values defined in a form definition.

The same goes for finisher options:

```yaml
finishers:
  finisherWithTranslationArguments:
    identifier: EmailToReceiver
    options:
      subject: My %s subject
      recipientAddress: foo@example.org
      senderAddress: bar@example.org
      translation:
        translationFile: path/to/locallang.xlf
        arguments:
          subject:
            - awesome
```

## Impact {#impact}

Form element property translations and finisher option translations can now use placeholders
to output translation arguments.