Localization Portal – Additional Features
Localization Portal – Additional Features
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.
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 define a unique game title, description, and icon for all supported languages.
Title and Description
To set localized game titles and descriptions:
- Access the portal’s Game Info section. Here you may set a localized version of the game title (name) and description for any of the supported languages.
articles/game settings|Game Settingswindow in Roblox Studio.
- When you’re finished editing the title/description for a non-source language, click Save.
To upload unique game icons for various languages:
- Access the Manage Translations page from the Languages section.
- Select the Game Information section.
- Confirm the selected language in the pull-down menu in the upper-right corner.
- Click inside the icon image box and choose an image file from your computer.
- Once uploaded, click Save.
Previewing Translations »
To preview how the game title and description will appear in any language you defined:
- Navigate to the game's main page.
- 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.
- 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.
- 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, 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|GameIDor copy the full URL from your browser.
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:
|Key||A custom key for implementing key-based lookups in scripts using
|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.|
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.
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.
Uploading the Spreadsheet
Once you have a complete .csv with all of your game’s translations, you can upload it 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.
To test game localization directly within Studio:
Back in the localization tools window, under Test Language → Locale, select a language to test in.
Start playtesting and confirm that translations from the localization portal are being used on the configured in-game instances.