Homepage

MatchingTranslations

Last edit: Apr 01, 2026

MatchingTranslations

Severity: error | Type: YAML

This check ensures that translation files for different languages have the same keys, helping to avoid inconsistencies and making it easier to spot errors and maintain translation files.

Examples

✗ Incorrect Code Example (Avoid using this):

# app/translations/en/item.yml
en:
  app:
    item:
      title: "Item"
      description: "Description"

# app/translations/de/item.yml
de:
  app:
    item:
      description: "Beschreibung"

The title key is missing from the German translation file.

✓ Correct Code Example (Use this instead):

# app/translations/en/item.yml
en:
  app:
    item:
      title: "Item"
      description: "Description"

# app/translations/de/item.yml
de:
  app:
    item:
      title: "Artikel"
      description: "Beschreibung"

Both translation files have the same keys.

Configuration

The default configuration for this check:

MatchingTranslations:
  enabled: true
  severity: error

Disabling This Check

There should be no need to disable this check. For keys set via the UI that are not intended to be part of the codebase, use the appropriate configuration option in app/config.yml.

Resources

Questions?

We are always happy to help with any questions you may have.

contact us