Skip to main content
Keel Docs Showcase

Interface languages

What it does

Keel's menus, buttons and messages come in English, Croatian and German. Content stays in the languages it is written in. These options decide which interface languages users can pick, and which one they get before they pick. Admins can set the same two things in Customize → Language; once saved there, that choice wins over these options.

Default

All three languages. Until a user picks one, Keel follows the language of their Pimcore account.

Options

KeyDefaultWhat it does
languages.available[en, hr, de]Languages users can pick: any of en, hr, de
languages.defaultnoneLanguage until a user picks one. Empty (~): the user's Pimcore account language. Must be one of available.

Example

yaml
keel:
    languages:
        available: [en, hr]
        default: hr

default: de with available: [en, hr] stops cache:clear with keel.languages.default: "de" is not one of available (en, hr).

Which language a user gets

The first of these that is in available (Customize's list when an admin saved one there, else languages.available):

  1. The language the user picked (saved with the user)
  2. The default chosen in Customize → Language, else languages.default
  3. The language of the user's Pimcore account
  4. The first language of available

A change of languages.default reaches every user who has not picked a language. If the language a user picked is no longer in available, Keel goes on down this list.

The Language page

Users pick their language under Setup → Language, which opens My view at the Look group. The choice lists the offered languages and warns that the whole admin panel will refresh. With only one language in available, there is nothing to pick.

The choice is saved with the user, so it follows them to any browser. Reset to team default goes back to the project default below. The older Keel pages in the classic Pimcore admin keep a separate Language page that saves the same choice. The beta has no language choice in My view.

keel:setup texts in the console are English only. Pimcore notifications from assignments follow each recipient's Pimcore language.

What admins change in Customize

Customize → Language (Customize): the default for everyone (Each person's Pimcore language or one language) and which languages people can choose. Nothing is stored there until an admin changes it; until then these keel.yaml options decide. Reset to automatic in Customize hands it back to keel.yaml. Each user still picks their own language in My view.