Localization best practices

Localization best practices

Koji speaks English by default, but it supports multiple languages. This page describes the best practices for you to set up your virtual assistant in a non-default language.

Supported languages

Koji supports the following languages:

  • English (default)

  • French

  • Spanish

  • German

  • Portuguese

  • Brazilian Portuguese

  • Polish

  • Italian

Language detection

Here are a few points to know about the language detection and management:

  • A user's language is automatically detected based on their account preferences/environment settings.

  • Koji backoffice is presented in English.

  • You can edit Koji content in the language of the current user.

  • The anonymous account uses English by default.

Switching languages

To modify the content in a specific language, you must switch to this language first. To do so:

  1. In your Jira Service Management project, go to Koji backoffice.

  2. Use the language selector to switch to the language whose content you want to modify.

image-20250704-131134.png

Now, you can modify the content in the chosen language.

Modifying content

To customize content, go to Koji settings and scroll down to the Global settings section.

image-20250708-095423.png

Welcome message

You can modify welcome messages for each supported language.

  1. Click Edit in the Welcome section.

  2. Modify the content: you can use either plain text or HTML.

  3. Click Save.

image-20250704-131617.png

Bot name

As the bot name is international, you can define only one for all the supported languages. To modify the name:

  1. Click Edit in the Bot name section.

  2. Modify the content: you can use either plain text or HTML.

  3. Click Save.

Request management

The Jira Service Management content is not translated and is used as is. If you have JSM in Spanish by default (for project settings, request fields, and so on), this language will be used.

Other elements of Request management will be localized in the language of the current user.