Language Fallbacks in Joomla

Available from Joomla 6.2

Joomla supports language fallbacks for language strings.

This is useful when a site uses a regional language variant, but an extension does not provide translations specifically for that variant.

For example, a Joomla site may use Swiss German (de-CH), while an extension only provides German (de-DE) and English (en-GB) language files.

Without a configured fallback, untranslated extension strings may be displayed in English. With a fallback configured, Joomla can use the German translation instead.

How Language Fallback Works

Language fallback works per language string.

For example, assume the active language is de-CH and a fallback to de-DE has been configured.

If an extension contains:

COM_EXAMPLE_TITLE="Titel Schweiz"

in its de-CH language file, Joomla uses that value.

If another string is missing from de-CH but exists in de-DE:

COM_EXAMPLE_DESCRIPTION="Beschreibung"

Joomla uses the de-DE value.

The resulting interface can therefore contain:

• strings from de-CH where translations exist;
• strings from de-DE where they are missing from de-CH;
• the normal Joomla fallback, typically en-GB, where no translation is available.

The complete language file is not replaced by the fallback language. Fallback is resolved individually for each missing language string.

Configuring a Language Fallback

A site administrator can configure language fallbacks from the Joomla Administrator.

Go to:

System → Manage → Languages

Select Options and open the Language Fallback tab.

Under Fallback Overrides, add a new entry.

For example:

Save the configuration.

When Joomla loads language strings for de-CH, missing strings can now be loaded from de-DE.

The fallback language should normally be installed on the site.

Example

Consider a Joomla site using:

de-CH

as the Administrator language.

A third-party extension provides language files for:

de-DE
en-GB

but does not provide a de-CH translation.

Configure:

de-CH → de-DE

Joomla will then use the available German strings instead of immediately falling back to English.

Strings supplied by a de-CH language file still have priority over their de-DE equivalents.

Language Pack Defaults

A language pack can provide its own recommended fallback.

Language pack maintainers can add the optional <fallback> element to the language's langmetadata.xml file.

For example, the metadata for de-CH could contain:

<metadata>
    ...
    <fallback>de-DE</fallback>
    ...
</metadata>

This tells Joomla that de-DE should be used for missing de-CH strings.

A fallback defined by the site administrator overrides the fallback supplied by the language pack.

Fallback Priority

Joomla determines the fallback for a language in the following order:

1. Administrator fallback override

   Configured under Languages → Options → Language Fallback.

2. Language pack fallback

   Defined using <fallback> in langmetadata.xml.

3. Normal Joomla language behaviour

   If neither of the above is configured, Joomla behaves as before and ultimately uses its normal default language fallback.

This means language teams can provide sensible defaults while site administrators can adjust them when required.

Opt-in Behaviour

Language fallbacks are optional.

If neither the language pack nor the administrator defines a fallback, Joomla behaves as it did previously.

Existing Joomla installations therefore do not need to configure anything after upgrading.

When to Use Language Fallbacks

Language fallbacks are especially useful for regional language variants where many extensions provide a translation for the main language but not for every regional variant.

For example:

de-CH → de-DE

The feature allows an extension to display a closely related translation instead of falling back directly to English, while still allowing regional translations to override individual strings whenever they are available.