Introduction to Localization

Introduction to Localization

10 min

Roblox is dedicated to growing our audience of players and developers. As the number of international players grows, localization will help those players understand and enjoy your games.

Why Localize?

At its core, localization is about making a game more meaningful and engaging to a particular player base. Every region of the world has its own culture, language, and customs, so your game should ideally display region-specific language in its buttons, instructions, character dialogue, etc.

Getting Started

In Roblox, localizing a game involves three primary stages:

Text Collection and Storage Adding and Managing Translations Utilizing Translations

If you’re new to localization, read on to explore the cloud-based localization portal, the recommended method of storing, managing, and utilizing translations.

Text Collection and Storage

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

Once inside the portal, click the Settings tab and turn on Automatic Text Capture (ATC). This enables capture and storage of in-game strings when your game is played by anyone on Roblox.

ATC Usage Guidelines

For ATC to detect in-game text and add it to the localization portal, note the following:

  • The game must be played in the Roblox application or Roblox Studio.
  • If the game is played from your account, it may take 1–2 minutes for ATC to inject text into the localization portal.

Disabling ATC Per-Object

For some in-game content, you should disable automatic text capture. For example, ATC doesn’t need to track a TextLabel on a BillboardGui above an NPC which reads “Diva Dragonslayer” (the character’s name) because their name won’t change across languages.

To disable automatic text capture on a specific GuiBase2d|GUI object, un-check its GuiBase2d/AutoLocalize|AutoLocalize property in Studio or set it to false within a script.

Adding and Managing Translations

In the Languages section, you should first set the Game Source Language to one of the fully-supported languages on Roblox.

Next, in the Translated Languages section which follows, click the Add Language field and select a language from the menu.

Once added to the list, clicking on a language opens the Manage Translations page where you can manage your translations.

List of in-game source text strings gathered by automatic text capture or manual entry. A green indicator means that a translation has been added for the selected language, while gray indicates no translation exists.
The localized translation which will be used for the selected language.
List of GUI objects within the game where the string is found.
Log (history) of the changes made to a specific entry. If you're using automatic translation for the selected language, records of machine-generated translations will appear here.

Automatic Translation

At this time, automatic machine translation is automatically enabled on select experiences, with an ongoing rollout based on hours played. Based on the Game Source Language that you selected earlier, switches for enabling automatic translations in supported languages will appear:

At this time, the following automatic translations are available:

Currently Supported Languages
Chinese - Simplified
Chinese - Traditional

Utilizing Translations

When you’re ready to utilize translated content in your game, return to the portal’s Settings section and enable Use Translated Content.

Once enabled, you can test the translations directly within Roblox Studio as outlined in articles/game testing#player-emulator|Game Testing Modes.

From here, it’s recommended that you explore articles/localization portal additional features|Localization Portal – Additional Features for details on setting translated game titles/descriptions, assigning other translators to assist you, and more.

  • localization
  • language
  • translation
  • international