• Get started
  • Documentation

Add translations to a form

Translate forms into multiple languages for customers to raise requests in their preferred language in both team-managed and company-managed service projects. If your customers preferred language isn’t available, they’ll see the language the original form was created in - this is referred to as the primary language.

Add language

To add languages to create a translation:

  1. Once in the form builder, select the Translate tab.

  2. If no translations have been created, select Add languages and select the languages you wish to add.

  3. If you already have translations associated with this form, select Add languages under the languages you’ve already added from the navigation on the left.

Languages won’t be visible to customers until translations have been reviewed, and the Available to customers toggle is enabled. This is so untranslated, or incorrect forms aren’t automatically surfaced to customers.

The primary language is automatically determined. This is what the original form was created in and the fallback language shown to customers in the portal. If this is incorrect, you can easily change it to the correct language.

Translate form

To translate the form into a new language:

  1. Once in the form builder, select the Translate tab.

  2. Select the language you wish to update translations on, or select Add language to choose a new language.

    1. Each language has a status which shows either how many translations are left to update, or if translations are complete.

  3. Select a field or element on the form, and enter the translation in the panel on the right. Continue doing this until all translations on your form are complete.

    1. Fields marked with a orange dot indicate whether translations are missing

  4. Once translations are complete, enable the Available to customers toggle so customers are able to access this language.

    1. If a warning symbol () appears, it means this language won’t be available on the portal until it is also enabled in Language support. Read more about adding languages to the portal in Language support

Choice fields linked to Jira fields or data connections can’t be translated at this time.

Remove language

To remove languages:

  1. Once in the form builder, select the Translate tab.

  2. Select the trash icon () next to the language you wish to remove.

  3. Once removed, those translations will be deleted and you’ll need to redo translations if you decide to add the language again later.

How languages may display

If the primary language and translations have been set on form, and the user's language matches one of the available translations, the form will be shown in the translated language.

However if there are no translations set on the form, or the user's language doesn’t match any of the available translations, the form will be shown in the primary language.

Example

John is an admin and has created a ‘Leave request’ form.

The primary language of the form is set to English (UK), and there is a French and German translation available to customers.

Jane’s user locale is set to French (France), and she goes to raise a ‘Leave request’ form in the portal. Since this translation is available, she is served the ‘Leave request’ form in French.

Charlie’s user locale is set to Japanese (Japan), and he goes to raise a ‘Leave request’ form in the portal. Since this translation isn’t available, Charlie is served the ‘Leave request’ form in the primary language which is English (UK).

There are differences in the order the locale is determined when it comes to exporting forms which may affect date and time formatting.

For XLSX exports, the order of locale is:

  • User locale

  • Jira Service Management project locale

  • Jira system locale

For PDF exports, the order of locale is:

  • Translation

  • Primary language

  • Legacy language

  • Jira Service Management project locale

  • Jira system locale

For forms attached to issues as PDFs, the order of locale is:

  • Translation

  • Primary language

  • Legacy language

  • User locale

  • Jira Service Management project locale

  • Jira system locale

Still need help?

The Atlassian Community is here for you.