Issue Bug Under Review Stale

#110330Translation wizard offers Translate mode for Free Mode source languages

Eric Harrer 07/30/26, 09:45 updated 07/31/26, 22:58

Description

Problem

When Free Mode content from a non-default language is selected as the source in the translation wizard, the wizard still offers both Translate and Copy as localization modes.

A Free Mode source record has no relation to a default-language record through l18n_parent. The wizard therefore cannot derive a connected translation from that source record.

Nevertheless, the wizard allows the editor to select Translate, which represents the connected localization mode. Completing the wizard still creates a target-language record with an empty l18n_parent. The resulting record is therefore Free Mode content, regardless of the selected localization mode.

The Translate option consequently suggests that a connected localization can be created, although the selected mode has no corresponding effect on the resulting record structure.

Prerequisites

  • TYPO3 v14 or TYPO3 15.0.0-dev
  • A site with a default language
  • At least two additional languages
  • A page translated into both additional languages
  • At least one Free Mode content element in the first additional language
  • Default localization wizard configuration

Steps to reproduce

  1. Create a page in the default language.
  2. Create page translations for two additional languages, for example German and Spanish.
  3. Create a content element in the first additional language in Free Mode, either independently or by using the Copy localization mode.
  4. Verify that the Free Mode content element has an empty l18n_parent.
  5. Open the language column of the second additional language in Content > Layout.
  6. Start the translation wizard.
  7. Select the first additional language as the source language.
  8. Select the Free Mode content element.
  9. Continue to the localization-mode step.
  10. Select Translate as the connected localization mode.
  11. Complete the wizard.
  12. Inspect the content element created in the target language.

Actual behavior

The localization-mode step offers both Translate and Copy.

Selecting Translate creates a target-language content element with an empty l18n_parent. The created record is therefore in Free Mode and is not connected to a default-language record.

The resulting data structure is equivalent to the structure created through Copy. Selecting the connected localization mode does not create a connected translation and has no meaningful effect on the result.

An attached video demonstrates the complete workflow using the following languages:

  • English as the default language
  • German as the source language containing Free Mode content
  • Spanish as the target language

In the video, German is selected as the source language and Translate is selected as the connected localization mode. The resulting Spanish content element is nevertheless created in Free Mode with an empty l18n_parent.

The video confirms that the offered localization-mode choice does not correspond to the localization structure that the wizard can actually create.

Expected behavior

Translate must not be offered when the selected source records are Free Mode records from a non-default language and no default-language translation parent can be derived.

When all selected source records meet this condition, Copy is the only structurally valid Core localization mode.

With the default wizard configuration, the wizard should therefore apply the copy behavior directly and skip the localization-mode step because no meaningful choice remains.

When the selected records from a non-default source language are connected to default-language records, both Translate and Copy must remain available.

Reproducibility

  • Reproducible: Yes
  • Initially observed: Translation Handling Initiative meeting on 2026-07-24
  • Confirmed affected version: TYPO3 v14
  • Confirmed affected version: TYPO3 15.0.0-dev
  • Earlier versions: Not verified
  • Regression: Not verified
  • Demonstration: Reproduction video attached

Technical analysis

A connected localization requires a default-language origin that can be assigned to the target record through l18n_parent.

A Free Mode source record from a non-default language does not have such a relation. The translation wizard therefore cannot derive a default-language origin for the new target-language record.

As a result, selecting Translate cannot produce the connected record structure represented by that mode. The wizard instead creates the same Free Mode structure that is expected from Copy.

The availability of Translate should therefore depend not only on the selected source language, but also on whether the selected source records provide valid relations to default-language records.

Forge issue #95909 established the general behavior that the localization-mode step should be skipped when only one localization mode is available. The missing condition here is detecting that Translate is not applicable when the selected source records are Free Mode records from a non-default language.

Scope

  • In scope: Selections consisting entirely of Free Mode records from a non-default source language
  • In scope: Removing the structurally unavailable Translate option
  • In scope: Skipping the localization-mode step when Copy is the only remaining Core mode
  • Out of scope: Selections containing both connected and Free Mode records
  • Out of scope: Third-party translation or machine-translation integrations
  • Out of scope: Changing the handling of connected records from a non-default source language

Additional information

A reproduction video is attached. The demonstration uses English as the default language, German as the Free Mode source language, and Spanish as the target language.

It shows that selecting German Free Mode content as the source and choosing Translate still creates Spanish Free Mode content. This demonstrates that the offered localization-mode choice does not affect the resulting relation structure.

Forge #95909 implemented skipping the localization-mode step when only one mode is available. It does not detect that Translate is unavailable for Free Mode records from a non-default source language.

Forge #109833 concerns another unnecessary localization-mode step in the new wizard, but only for empty pages or an empty record selection.

Forge #86231 documents the structural limitation of deriving translations from a Free Mode localization, but does not address the corresponding localization-mode selection in the current wizard.

Reviews 1

History 23