Last modified: June 01, 2022Author: Jakub Pomykała

Learn how to manage languages in your project. In SimpleLocalize, every language contains 'language key' for developers and exports, and 'language name' which can be treated as user-friendly display name. We don't restrict you to use any specific format for 'language keys', but it's worth to consider using one of the standard formats like ISO 3166-1.

How to add a new language

  • Open translation project in web application.
  • Go to 'Languages' tab
  • Add new language by clicking 'Add language' button on top right side
  • Put language key and language name
  • Click 'Add language'
  • Done! 🎉

How to rearrange languages

You can rearrange language order which will affect order in the translations view, and in the exported files. You can save languages order for the whole project, which will be used as default order for every project contributor. Every user can rearrange the languages order on their own. Translators cannot change project order, but they can adjust the view for themselves.

SimpleLocalize: rearrange languages

To change language order, simply drag-and-drop the languages on the list. When the order is done, save the changes for the project or just for your own use.

Default language

The default language is the language that will be prioritized during auto-translation. It will be used as a fallback language for translation in translation hosting. In the 'Translations' tab it will be shown as a source language.

default language

Language flags and icons

By default, the flag icons are displayed automatically based on language keys. SimpleLocalize uses ISO 3166-1 standard with 'Alpha-2' notation. The 'Alpha-2' means that we use only 2-letter country codes. The flag will show up regardless letter case. For example:

  • es_MX - shows Mexico flag
  • es_ES - shows Spanish flag
  • es_es - shows Spanish flag
  • es - shows Spanish flag

There are a few exceptions in showing country flags:

  • zh_hans or zh_hant will show the Chinese flag.
  • A language key which starts from en will show the Great Britain flag.

Set language flag or icon manually

SimpleLocalize: change flags for languages

You can also change flag for languages regardless of the language key. Adjust the flag manually for your project needs, so they correspond to the selected language. Flags setup is a great way to organize your project, as you can recognize the language and location with just a glance.