PcoWSkbVqDnWTu_dm2ix
We use cookies on this site to enhance your user experience

Localization Portal – Additional Features

Localization Portal – Additional Features

Oct 10 2019, 12:32 PM PST 10 min

Beyond the features covered in the articles/Introduction to Localization on Roblox|intro tutorial, the localization portal lets you set translated game titles/descriptions, assign other translators to assist you, and more. If you haven’t used the portal or you’re new to localization, please read articles/Introduction to Localization on Roblox|Introduction to Localization first.

To access the localization portal, navigate to your game’s main page, click the button, and select Configure Localization from the context menu.


Localizing Game Info

In addition to in-game text localization, Roblox lets you specify a localized game title and description, as well as upload unique articles/Game Icons Tips|game icons and articles/Thumbnail|game thumbnails for any supported language. All of this can be done by navigating to LanguagesManage Translations and selecting Game Information.

Name and Description

To set a localized name and description for your game:

  1. In the left column, click Name or Description and enter a suitable translation for the language selected in the upper-right pull-down menu.
  2. When finished, click Save.

Game Icon

To upload a unique game icon for any language:

  1. In the left column, click Icon.
  2. Confirm the selected language in the upper-right pull-down menu.
  3. Click inside the icon image box and choose an image file from your computer.
  4. Once uploaded, click Save.

Game Thumbnails

To upload localized game thumbnails:

  1. In the left column, click Thumbnails.
  2. Confirm the selected language in the upper-right pull-down menu.
  3. Click inside the empty thumbnail image box and choose an image file from your computer.
  4. Continue choosing thumbnails if desired, up to the limit of 10.
  5. Once finished, click Save.

To see how the game title, description, and thumbnails will appear in any language you defined:

  1. Navigate to the game's main page.
  2. Scroll to the very bottom of the page, locate the language selection box, and select a language for which you've provided a localized title/description.
  1. Once the page reloads, you should see your settings applied.

Clearing Untranslated Strings

In some cases, Automatic Text Capture (ATC) will capture source text strings from objects that should ideally be translated in game by disabling their GuiBase2d/AutoLocalize|AutoLocalize property and managing them via articles/utilizing localization apis|localization APIs.

To clear source text strings that don’t have any valid translations, click the Clear button in the portal’s Settings section:

Adding Other Translators

When translating into unfamiliar languages, you may want to specify other Roblox users who are allowed to add translations to the game.

  1. In the portal’s Translators section, select whether you’d like to add translators by Username, User ID, or Group ID.
  1. Enter the username or ID and click the “add” icon.
  1. When ready, send your translator(s) the link to the Manage Translations page as in the example below — just replace “GAME_ID” with the game’s DataModel/GameId|GameID or copy the full URL from your browser.

Translation Analytics

For tracking overall game localization, you can download bi-monthly reports which include data like:

  • Total number of source strings and the number/percentage translated for each language.
  • Information on each translator and their contributions.
  • Year-to-date analytics for translator contributions.

To download reports, access the portal’s Reports section, select a date range, and click the Download button. This will download a .csv spreadsheet which you can inspect in your preferred application.

Localizing With CSV Files

If translators don’t have access to the localization portal or prefer not to use it, a .csv file can be downloaded for editing and then uploaded later with the desired changes.

To download a .csv spreadsheet:

  1. In Roblox Studio, click the Tools button in the Localization section of the Plugins tab.
  1. In the localization tools window, under Cloud Localization Table, click the download button next to Download table as CSV.

Editing the Spreadsheet

In the spreadsheet, the first four columns are as follows:

Column Description
Key A custom key for implementing key-based lookups in scripts using articles/utilizing localization apis|localization APIs.
Context An Instance reference which may be used to provide context overrides.
Source The in-game source text strings gathered by automatic text capture or manual entry.
Example This is ignored by auto-localization and can be used to provide additional notes to human translators, for instance details about NPCs referenced in the text, game-specific terms that should not be translated, etc.
A B C D E F G
Key Context Source Example
  Options
  Start
 

To specify translations for your game, translators should add a language code column for the language they’re translating, for example es or pt (please refer to the language code reference table below). Within the column, source text strings from the Source column should be cross-referenced for supplying the correct translations.

A B C D E F G
Key Context Source Example es pt
Options Opciones Opções
Start Iniciar Iniciar
 

The following table outlines the languages currently supported in the localization portal. Those highlighted in yellow are fully supported by the Roblox platform/applications.

Language Code Language
de German Deutsch
en English English
es Spanish Español
fr French Français
jp Japanese 日本語
ko Korean 한국어
pt Portuguese Português
zh-hans Chinese (Simplified) 中文(简体)
zh-hant Chinese (Traditional) 中文(繁體)
bg Bulgarian български
bn Bengali বাংলা
bs Bosnian босански
cs Czech Čeština
da Danish Dansk
el Greek ελληνικά
et Estonian Eesti
fi Finnish Suomi
hi Hindi हिन्दी
hr Croatian Hrvatski
hu Hungarian Magyar
id Indonesian Bahasa Indonesia
it Italian Italiano
ka Georgian ქართული
kk Kazakh қазақ тілі
km Khmer ភាសាខ្មែរ
lt Lithuanian Lietuvių
lv Latvian Latviešu
ms Malay Bahasa Melayu
my Burmese ဗမာစာ
nb Bokmal Bokmål
nl Dutch Nederlands
fil Filipino Filipino
pl Polish Polski
ro Romanian Română
ru Russian русский
si Sinhala සිංහල
sk Slovak Slovenčina
sl Slovenian Slovenski
sq Albanian Shqipe
sr Serbian српски
sv Swedish Svenska
th Thai ภาษาไทย
tr Turkish Türkçe
uk Ukrainian україньска
vi Vietnamese Tiểng Việt

Uploading the Spreadsheet

Once you have a complete .csv with all of your game’s translations, you can upload it within Roblox Studio.

  1. In the localization tools window, under Cloud Localization Table, click the update button next to Update with new content from CSV.

  2. Select the .csv file and review the details in the confirmation window. If everything looks correct, click the Confirm button to upload the updated spreadsheet.

Testing

To test game localization directly within Studio:

  1. Back in the localization tools window, under Test LanguageLocale, select a language to test in.

  2. Start playtesting and confirm that translations from the localization portal are being used on the configured in-game instances.

Tags:
  • localization
  • language
  • translation
  • international