= Multi-language applications
:description: Throughout this page, you will see how you can translate the application menus.

Throughout this page, you will see how you can translate the application menus.

The menus in Bonita User and Administrator applications are available in English only by default. But, depending on your requirements, the menus can be translated into other languages too by updating Bonita layout. Using the same procedure, custom applications menus can be translated as well.
This documentation is only about the menus. For more information regarding translations at the page level, go to the xref:multi-language-pages.adoc[multi language pages] page.

== Updating the menu widget

In order to get the menu translated, you need to ensure that the `uiTranslate` directive is present for the menu entries display names in `customLayoutMenuBonitaV_` widget.

In order to do so, you can follow this procedure:

. Update your widget inside Bonita UI Designer.
. {blank}
+
[cols=3*]
|===
| In the _Template_ section, add "
| uiTranslate" after _menu.displayName_ and _childMenu.displayName_ wherever it is. For example, *menu.displayName
| uiTranslate*.
|===

. Save the widget.

image::images/multi-language-applications/menu-widget.png[Menu-widget]

== Updating the layout

Note that the translation mechanism has been added to the menu, you need to modify the layout to translate the menu entries. In order to do so, you can follow this procedure:

. Update your layout inside Bonita UI Designer. For more information regarding customizing the layout, go to the xref:customize-layouts.adoc[customize layouts] page.
. Make sure your layout uses the version of the menu widget you just updated (click on the menu widget in the whiteboard to check its name and version and use the replace feature at the top right corner of the properties panel if it is not the right version).
. Inside the Localization section of the assets panel, click on the pencil icon at the right of the localizaton.json file to edit it.
image:images/multi-language-applications/edit-localization.png[Edit-localization]
. The localization.json file shows four different sets of strings based on the languages available.
image:images/multi-language-applications/localization.png[Localization]
. Now you need to add all the new keys in English which are the menu entry display names for the application you want to translate. For example, you will add the menu entry keys of Bonita User Application such as Processes, Cases, and Tasks inside fr-FR, es-ES, jp-JP, and pt-BR objects.
image:images/multi-language-applications/add-keys.png[Add-keys]
. Click on *Save* to save the changes you made in the localization.json file.
. Click on *Close*.
. Save and export the layout.
. Now, deploy the layout on your target runtime and use it in your applications.
