Get Started

To translate custom field options with TFO, you first need to create a new custom field and then define the translations for the options that you define.

TFO for Jira enables the translation of the custom field options only. If you want to translate the name of the new custom field, you can use Jira’s translate feature by selecting Cog > Translate in the Custom Fields page.

Create a New Custom Field

Once you have installed TFO, create a new custom field for one of the types supported by the app.

  1. Select Issues from the Jira Adminstration menu.

  2. In the left sidebar, select Custom Fields under Fields.

  3. Click Add Custom Field.

  4. In the Select a Field Type screen, select All then type translate in the search bar.

  5. Select the required field type, e.g. Translate Fields Checkbox, then click Next.

  6. Define a name for the field, and then add your required options. In the example below, we add a field called Issue Review and then add the following options: Clear, Limited, Help Required.

  7. Click Create.

    An example Configure screen for a Translate Fields checkbox.

Translate the Custom Field Options

Once you have created your custom field and defined the options, you can translate the options using TFO for Jira.

  1. Select Issues from the Jira Adminstration menu.

  2. In the left sidebar, select Custom Fields under Fields.

  3. Locate your new custom field then select Configure from the Cog drop-down menu.

  4. Click Edit Options.

  5. Under Actions, click Translate for the option you want to translate.

    The Edit Options screen, with the Translate option highlighted.

    All the available languages in Jira are listed. The text box next to each language is where your translations are added. Only enter a translation for the language(s) that you require.

  6. Type the required translation for the selected option then click Save.

  7. Click Return then repeat steps 5 and 6 for each option.

See it in Action

Now that the custom field options are translated, they can be viewed in an issue screen where the custom field is used. Ensure the default user language is set to the same language as your translations, otherwise the original values of the options will be displayed. In the example below, our custom field options have been translated into French, our default user language is French and therefore the options are displayed in French. Users with a different default language will see the original values of the options, in this case, English.

A rendered example of a Translate Fields checkbox, using French.