Translations

A panel can show its texts in the language of the viewer. You set translations on the Translations tab of the Create panel / Edit panel form. The Message Field custom field has the same tab in its context settings (Configure Message Panel Field) - see Custom Fields.


What Is Translated

Everything a viewer sees of the panel, per language:

Text Source on the form Notes
Name Name (Basic Settings) Also the title of the modal window and of the window opened automatically
Description Description (Basic Settings) Up to 5000 characters; templates work as in the source
Message title Message Title (Message) Shown when a Message Type with a box (Info, Warning, Error, Success, Change) is chosen and the title is filled in. Up to 200 characters
Message Message (Message) The whole message in this language, in the same Render Type as the source, up to 20000 characters. Templates ({{ issue.key }}, {% if %}) work as in the source
Field “…” Name of a field of Additional fields to display Up to 255 characters
Values of field “…” Values of that field on the issue Pairs “value -> translation”, up to 50 per field and language, up to 255 characters each
Open button text Open button text (Modal Window) Shown when Show in modal window is on and the text is filled in. Also the title of the flag of a panel with a hidden name. Up to 100 characters
Close button text Close button text (Modal Window) Shown when Show in modal window is on and the text is filled in. Up to 100 characters

Values are matched by the text the panel shows: a field value that reads exactly as written on the left (spaces at the ends do not matter) is shown as its translation. This covers single and multiple choice options, priority, status, user names and plain text values.

A text left empty on the form is not on the tab. The panel then shows the app’s own default (Show Information and Close on the modal window buttons), as does the Open action of a flag.


Setting Up a Language

  1. Open the Translations tab and click Add translation.
  2. Choose the language in New language. A language that already has a translation is not offered. Up to 10 languages per panel.
  3. Below, each text of the panel is shown with its current source text (read-only) and an input for the translation. Empty inputs keep the source text.
  4. Click Save.

The list at the top of the tab shows the languages that already have a translation; choosing one opens its texts. Delete translation removes the chosen language. A language left without any text is not saved.

Field labels and values follow the selected display fields: a field removed from Additional fields to display loses its translations when the panel is saved.


Which Language the Viewer Gets

The language of the viewer’s Jira interface. On the customer portal it is the language of the portal, otherwise the language of the viewer’s profile. Each text is chosen on its own:

  1. the translation for the exact language (for example de-AT);
  2. otherwise the translation for the base language (de for de-AT, de-DE, de-CH);
  3. otherwise the source text.

A viewer whose language has no translation sees the panel exactly as without translations.

The app’s own interface texts are available in English and German; other languages fall back to English.


Where Translations Apply

  • Issue view panels
  • The modal window and its title, the window opened automatically and its flag
  • The customer portal: request details and request creation
  • The project and global pages and the dashboard gadget
  • The Message Field custom field: issue view, customer portal request view, issue create form and customer portal request form

Limits

Each translated text has the limit of its source field. The whole configuration, translations included, is saved as one record of up to 230 KB; a larger one is not saved and the form says so.

Translations are exported and imported with the configuration (JSON and CSV) - see Bulk Operations and Limits.


Next Steps