Localization Portal – Additional Features
Localization Portal – Additional Features
Beyond the features covered in the articles/Introduction to Localization on Roblox|Introduction to Localization
tutorial, the localization portal lets you set translated game title/description, upload localized icons and thumbnails, assign other translators to assist you, and more.
Reminder – Accessing the Localization Portal »
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 Languages → Manage Translations and selecting Game Information.

Name and Description
To set a localized name and description for your game:
- In the left column, click Name or Description and enter a suitable translation for the language selected in the upper-right pull-down menu.
- When finished, click Save.
- To see how the changes will appear, scroll to the bottom of the game’s main page, locate the language selection box, and select the language for which you provided a localized name and description.

articles/game settings|Game Settings
window in Roblox Studio.
Game Icon
To upload a unique game icon for any language:
- In the left column, click Icon.
- Confirm the selected language in the upper-right pull-down menu.
- Click inside the icon image box and choose an image file from your computer.
- Once uploaded, click Save.
Game Thumbnails
To upload localized game thumbnails:
- In the left column, click Thumbnails.
- Confirm the selected language in the upper-right pull-down menu.
- Click inside the empty thumbnail image box and choose an image file from your computer.
- Continue choosing thumbnails if desired, up to the limit of 10.
- Once finished, click Save.
Localizing Game Products
To localize game products like /articles/Badges Special Game Awards|badges
, navigate to Languages → Manage Translations and select Game Products.

On the target page, your game products should be listed in the left column. To localize a product:
- Expand the product by clicking on its name.

- Enter a localized product name in the input box on the right side of the panel.
- When ready, click Save.
- Click on the Description button and follow the same process.

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.
- In the portal’s Translators section, select whether you’d like to add translators by Username, User ID, or Group ID.
- Enter the username or ID and click the “add” icon.

- When ready, direct your translator(s) to the Translator Portal. On this page, they can see all of the games they’re allowed to help translate, along with the current progress (percentage) for the language selected in the portal’s upper-right selection menu.

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:
- In Roblox Studio, click the Tools button in the Localization section of the Plugins tab.

- 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 lookup 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 | ||||
Language Code Reference »
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 and Testing
Once you have a complete .csv file with all translations of your game, you can upload it from within Roblox Studio.
- In the localization tools window, under Cloud Localization Table, click the update button next to Update with new content from CSV.
- 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.
- Once uploaded, you can test the translations directly within Roblox Studio as outlined in
articles/game testing#player-emulator|Game Testing Modes
.