Importing translations

Games and internationalization

The world is full of different markets and cultures and, to maximize profits™, nowadays games are released in several languages. To solve this, internationalized text must be supported in any modern game engine.




Translators also usually prefer to work with spreadsheets.

Translation format

To complete the picture and allow efficient support for translations, Godot has a special importer that can read CSV files. All spreadsheet editors (be it Libreoffice, Microsoft Office, Google Docs, etc.) can export to this format, so the only requirement is that the files have a special arrangement. The CSV files must be saved in UTF-8 encoding and be formatted as follows:

  <lang1> <lang2> <langN>
KEY1 string string string
KEY2 string string string
KEYN string string string

The «lang» tags must represent a language, which must be one of the valid locales supported by the engine. The «KEY» tags must be unique and represent a string universally (they are usually in uppercase, to differentiate from other strings). Here’s an example:

id en es ja
GREET Hello, friend! Hola, Amigo! こんにちは
ASK How are you? Cómo está? 元気ですか
BYE Good Bye Adiós さようなら

CSV importer

