Files
zitadel/docs/docs/guides/manage/customize/texts.md
T
41cdc7805f feat(i18n): add Ukrainian language support (#10696)
## Summary
  - Add comprehensive Ukrainian language support to ZITADEL
  - Complete translation of all user-facing interfaces
  - Integration with existing language configuration system

  ## Changes Made
- ✅ **Console translations**: Complete Ukrainian translation for admin
console (2,861 translated strings)
- ✅ **Login interface**: Ukrainian translations for authentication flows
(535 strings)
- ✅ **Email notifications**: Ukrainian translations for system emails
(68 strings)
- ✅ **Common texts**: Ukrainian translations for success/error messages
(1,417 strings)
- ✅ **Language configuration**: Added Ukrainian to supported languages
and Angular locale registration
- ✅ **UI integration**: Added Ukrainian option to language selection
forms

  ## Translation Quality
  - Professional translations using established Ukrainian IT terminology
  - Formal language appropriate for business software
- Consistent terminology across all components (Users→Користувачі,
Organization→Організація, etc.)
  - Preserved all technical placeholders, HTML tags, and formatting

  ## Contributing Guidelines Compliance
  - ✅ Followed semantic commit message format
  - ✅ Added Ukrainian to all required configuration files
  - ✅ Maintained consistent file structure with existing languages
  - ✅ Used formal Ukrainian appropriate for business software

The Ukrainian translation is now ready for review by the ZITADEL team! 🚀

---------

Co-authored-by: Marco A. <[email protected]>
2025-12-11 15:37:31 +01:00

2.7 KiB
Raw Blame History

title
title
Customized Texts

You are able to customize the texts used from ZITADEL. This is possibly on the instance or organization level.

Message Texts

Sometimes the users will get an email or phone message from ZITADEL (e.g Password Reset Request). ZITADEL already has some good standard texts, but maybe you would like to customize it for your organization.

Go to the message text policy on your organization and you will find the different kinds of messages that are sent from ZITADEL. Choose the template and the language you like to edit. You can now change all the texts from a message. As soon as you click into a input field you will see some attribute chips below the field. These are the parameters you can include on this specific message.

Message Texts

Login Texts

Like the message texts you are also able to change the texts on the login interface. First choose the screen and the language you like to edit. You will see the default texts in the input field and you can overwrite them by typing into the box.

Message Texts

Reset to default

If you don't like your customization anymore click the "reset policy" button. All your settings will be removed and the default settings of the system will trigger.

Internationalization / i18n

ZITADEL is available in the following languages

  • German (de)
  • English (en)
  • Spanish (es)
  • French (fr)
  • Indonesian (id)
  • Italian (it)
  • 日本語 (ja)
  • Polish(pl)
  • 简体中文(zh)
  • Bulgarian (bg)
  • Portuguese (pt)
  • Macedonian (mk)
  • Czech (cs)
  • Russian (ru)
  • Dutch (nl)
  • Swedish (sv)
  • Hungarian (hu)
  • 한국어 (ko)
  • Romanian (ro)
  • Turkish (tr)
  • Ukrainian (uk)

A language is displayed based on your agent's language header. If a users language header doesn't match any of the supported or restricted languages, the instances default language will be used.

If you need support for a specific language we highly encourage you to contribute translation files for the missing language.

Restrict Languages

If you only want to enable a subset of the supported languages, you can configure the languages you'd like to allow using the restrictions API. The login UI and notification messages are only rendered in one of the allowed languages and fallback to the instances default language. Also, the instances OIDC discovery endpoint will only list the allowed languages in the ui_locales_supported field.

All language settings are also configurable in the consoles Languages default settings.

Languages