- What Is Translated
- Setting Up a Language
- Which Language the Viewer Gets
- Where Translations Apply
- Limits
- Next Steps
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
- Open the Translations tab and click Add translation.
- Choose the language in New language. A language that already has a translation is not offered. Up to 10 languages per panel.
- 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.
- 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:
- the translation for the exact language (for example
de-AT); - otherwise the translation for the base language (
deforde-AT,de-DE,de-CH); - 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
- Configuration Basics - The configuration form
- Custom Fields - The Message Field custom field
- Modal Windows - Modal window, auto-open and the flag

