Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

This feature is available in Refined for Jira Service Management Data Center version 3.0 and up.

...

You can add a language switcher to sites, categories or portals.

What is translated?

Location

Description

Jira text

If Jira supports the language a users switches to, Jira texts are updated automatically. If Jira does not support the language, install a language pack and ensure you’ve translated portal-related strings in the project’s Language support.

Jira Service Management requests

To translate JSM portal names, request types, request type fields, and descriptions, go to the service project admin section under Language support for Jira 8.16 and newer. Read more.

Refined features

To translate the Refined site and site structure, landing page layout, footer, modules and more, use the Custom text variables & Dictionary feature.

Add a language switcher

The language switcher automatically appears when you add one or more languages in Refined Administration > the Languages tab. Click the + Add language button and select a language from the list. You can manually add languages that are not in this list by entering a language ISO code.

...

We support the languages Jira offers out of the box, as well as Vietnamese and Portuguese (Portugal): see the list below for details. Is your language not on this list? Contact us.

Language

ISO code

Note

Chinese Simplified

(zh_CN)

Chinese Traditional

(zh_TW)

Czech (Czech Republic)

(cs_CZ)

Danish (Denmark)

(da_DK)

Dutch (Netherlands)

(nl_NL)

English (UK)

(en_UK)

Invalid locale but would be equivalent to en_GB

English (United States)

(en_US)

Default language

German (Germany)

(de_DE)

Estonian (Estonia)

(et_EE)

Finnish (Finland)

(fi_FI)

French (France)

(fr_FR)

Hungarian (Hungary)

(hu_HU)

Icelandic (Iceland)

(is_IS)

Italian (Italy)

(it_IT)

Japanese (Japan)

(ja_JP)

Korean (Korea)

(ko_KR)

Norwegian Bokmål

(no_NO)

Also listed as Norwegian (Norway). Would be equivalent to nb or nb_NO

Polish (Poland)

(pl_PL)

Portuguese (Brazil)

(pt_BR)

Portuguese (Portugal)

(pt_PT)

Not natively supported by Atlassian - you’ll need to install a Jira language pack.

Romanian (Romania)

(ro_RO)

Russian (Russia)

(ru_RU)

Slovak (Slovakia)

(sk_SK)

Spanish (Spain)

(es_ES)

Swedish (Sweden)

(sv_SE)

Vietnamese (Vietnam)

(vi_VN)

Not natively supported by Atlassian - you’ll need to install a Jira language pack.

Custom translations, wordings and phrases

...

Take the language switcher to the next level by adding your own translations, wordings and phrases.

The custom translations build on the custom text variables. When adding a custom variable, you can see multiple fields: one for the default value, and one per language you’ve enabled in Refined.

Expand
titleAdd a dynamic category name

In this example, we translate a category called Help & info. After completing these steps, the category name will automatically be translated anywhere it appears on your site.

  1. Go to the Refined Administration > Languages > Expand Dictionary.

  2. Click Add text variable and add the text variable’s name and translations.

  3. Image Removed
  4. Save your entries and go to the Site Builder tab.

  5. Click the Cogwheel of the category you wish to translate.

  6. Enter your new text variable as the category’s name.

Expand
titleAdd an announcement banner

In this example, we create an announcement banner that notifies users of planned maintenance.

  1. Go to the Refined Administration > Languages > Expand Dictionary.

  2. Click Add text variable and add the text variable’s name and translations.

    Image Removed
  3. Save your entries and go to the Announcements tab. We will build the message in two parts: the message in the text variable and the data in a general format.

    Image Removed

...

titleAdd a module with text and custom text variables

In this example, we add a text to the top of the Search Highlight to inspire visitors to search for help. The entered text will be a combination of text and a text variable.

...

Go to the Refined Administration > Languages > Expand Dictionary.

...

Click Add text variable and add the text variable’s name and translations. In this screenshot you can see we added $sitename, which means the variable will contain the words types, and then the dynamically fetched name of the site.

...

Save your entries, go to a page on your website and add a Search Highlight module.

Add your new text variable into the module’s primary text.

...

using text variables to add your own translations, wordings and phrases.

Want to learn more?

Read Atlassian’s documentation: Jira Service Management internationalisation.

...