Language Admin
Learn how to add and edit languages for your tenant(s)
Last updated
Learn how to add and edit languages for your tenant(s)
Last updated
The Reporting Hub is a multi-language application and can be configured to any language. While the application will be installed with English as its default language, you can change the language of your tenant in two easy steps:
See below for a detailed walk-through of each step.
Select your profile picture or name to access the Admin Settings menu.
Select App Settings.
Select the Language Editor tab.
From the drop-down menu, select Add Language.
The Add New Language pop-up will appear, prompting you to enter both a Language Code and a Language Name.
In the first box, you will need to enter a two-letter ISO 639-1 code. (A full list of ISO 639-1 codes can be found here.) For example, if you want to add Spanish as an option, your ISO 639-1 code will be es.
In the second box, type the language name you want displayed on your drop-down menu. Then, select Add New Language.
From the drop-down menu, select the language you’ve added. This will bring up a list of every language tag associated with the Reporting Hub interface.
To change these tags to the language you’ve selected, click the Options button beside the dropdown and then Translate missing words. This may take several minutes.
Once the translation is complete, look over the tags to make sure you’re satisfied with the results. Any language tag translation can be edited manually. To do so:
In the row of the tag you want to edit, select the Edit icon () from the right-hand column.
Enter your preferred translation, and click Save.
Any language you’ve added can be deleted by: selecting it from the dropdown list, then selecting Options, and then Delete Selected Language.
Good to Know: Manually editing language tags can be useful, as the auto-translate function can be limited in its accuracy. For example: ISO 639-1 provides only one option for English, using American spelling.
If you’re setting up a new language for a regional client, you may wish to make manual changes to reflect a more natural language translation for native speakers. Rather than scrolling through every language tag, you can use the search bar to enter specific words that have discrepancies, and focus on editing those.
Once you’ve added a language using the Language Tags Editor, you’re ready to change the language of your Reporting Hub display.
Select your profile picture or name to access the Admin Settings menu.
Select App Settings.
Select the Tenant Admin tab.
From the list of tenants, select the ellipsis (...) next to the tenant you want to edit and then select Edit.
In the Edit Tenant menu, select your preferred language from the Language dropdown.
Select Save.
Good to Know: The Language menu will only display languages you’ve added using the Language Tags Editor.
New language tags may be added to the Reporting Hub as we update and add new features. These tags will not automatically be translated to whichever languages you have added to your Language Editor, and so you may be missing translations after an update.
For example, we added the Icelandic language to our Language Editor before several major updates. Hence, we are missing several translations for page tags; you can see where there are blanks under the Icelandic header.
Select the language you'd like to translate the missing phrases for from the Language dropdown.
Select Options.
Select Translate missing words. It may take several minutes to obtain the translations, depending on how many translations are missing.
The missing translations have been added. Any tags you've manually edited will not be overwritten.
By default, the Reporting Hub will use the public endpoint for calling Translator Service APIs. If your Translator uses a private endpoint, you'll have to add it to your Reporting Hub's app settings.
Copy your Translator's private endpoint from the Azure portal.
You can find it by navigating to your Translator service and selecting Keys and Endpoint under Resource Management.
Under Web API, copy the value for Text Translation.
In the Azure portal, navigate to your App Services list; you can use the search bar at the top of the page.
From the list of App Services, select your Reporting Hub app service.
If you deployed your Reporting Hub app to a specific slot on your app service, then expand the Deployment menu in the left menu pane; select Deployment slots; and select the desired slot.
On the left menu, expand the Development Tools menu and select Advanced Tools.
Select Go -> and Kudu tools will open in a new tab.
On the Kudu page, in the top menu, select Tools and Zip Push Deploy.
Scroll down in the file list and find appsettings.json. Select the pencil icon next to it.
In the text editor on the page, find "translatorurl" and replace the text beside it with the private endpoint value from step 1. Ensure the value is inside quotation marks.
Select Save.
