🚀 A new era: Kirby 4 Get to know
Skip to content

Translating blueprints

If you have editors from various language backgrounds, you can translate titles, form fields, section labels and more.

Note that the language version shown to the user is based on the user language, not on the selected content language. Blueprint translations also only affect the Panel. For translating your site, see Languages.

Blueprint titles

The title can be translated by passing an array of translations with the matching language code as key:

title:
    en: Example Page
    de: Beispiel Seite

Section labels

The same applies to labels...

sections:
  subpages:
    type: pages
    label:
      en: Articles
      de: Artikel

Labels, placeholders and help text

...and to everything else:

fields:
  street:
    label:
      de: Straße
      en: Street
    type: text
    placeholder:
      de: Bitte geben Sie einen Straßennamen ein…
      en: Please enter a street name…
    help:
      de: Der Name der Straße
      en: The name of the street

Options

fields:
  category:
      label:
        en: Category
        de: Kategorie
      type: select
      options:
        architecture:
          en: Architecture
          de: Architektur
        photography:
          en: Photography
          de: Fotografie

You can also use custom language variables via the * key:

options:
  architecture:
    *: category.architecture
  photography:
    *: category.photography

Text of headline, info or help text

fields:
  headline:
    label: headline
    text:
      de: Optionen
      en: Options