DRAFT: This page is still a draft and being actively written. If you find an error, please comment below.

Welcome to the Polyglots Contributor Handbook!

Within the chapters of this translator’s handbook, you’ll find everything you need to localize and internationalize WordPress into your language. We’re still working to bring over content from other pages, but enough content is here to get you started.

What is Internationalization?

Internationalization and localization (commonly abbreviated as i18n and l10n respectively) are terms used to describe the effort to make WordPress (and other such projects) available in languages other than English, for people from different locales, who use different dialects and local preferences.

The process of localizing a program has two steps. The first step is when the program’s developers provide a mechanism and method for the eventual translation of the program and its interface to suit local preferences and languages for users worldwide. WordPress developers have done this, so in theory, WordPress can be used in any language.

The second step is the actual localization, the process by which the text on the page and other settings are translated and adapted to another language and culture, using the framework prescribed by the developers of the software. WordPress has already been localized into many other languages (see our list of teams for more information).

This handbook explains how translators (bi- or multi-lingual WordPress users) can go about localizing WordPress to more languages.

About the Team

The polyglots team is responsible for ensuring WordPress is available in dozens of languages and many more regions. It’s a big job, which is why we need help from native speakers of many languages to make it possible.

The polyglots team consists of volunteers from around the globe who take care of translations for a specific language. Find out how you can become a part of your local team or how you can create one and help translate WordPress into your language.

The Polyglots team can be reached at the Polyglots blog.

Translating WordPress

The easiest way to start translating WordPress is to go to Translate.WordPress.org. Everyone can translate, as long as they are logged in to their WordPress.org account.

On Translate.WordPress.org you fill find a list of all the language WordPress can currently be translated into. If one of them is your language and it hasn’t been translated 100%, you can see the untranslated strings and suggest translations.

For your translations to get to WordPress, they will need to be approved by a local validator – a trusted member of the Polyglots community who can also appoint new validators.

Translation Tools

To ease the localization of software, a number of projects have been created, including one homegrown for localizing WordPress: GlotPress (Translate.WordPress.org).

While we recommend you use GlotPress for your translating needs, you’re free to use other software for the actual translation of WordPress, including Gettext directly and PoEdit. Ultimately, however, you’ll need to use GlotPress for the final creation of the WordPress package as well as for managing translations of other software, like plugins and themes.

This handbook details how to use GlotPress, Gettext, and PoEdit, and also gives a list of other tools you might use.

Rosetta Sites & Forums

Rosetta Sites are the gateways to local communities. They are the version of WordPress.org in a specific language. They are also the place where you can download WordPress in that language, find more information on the team of translators and see examples of websites that have been built with WordPress in that language.

Local forums are the place for discussions and support in a specific language.


Throughout this handbook, we’ll use a few terms that you might want to familiarize yourself with.

  • Internationalization: As mentioned above, internationalization is the method in which we make WordPress available in different languages and regions.
  • Localization: This term is often used interchangeably in this handbook with internationalization.
  • Locale: A locale (as opposed to “local”) is the combination of a language and a regional dialect. Locales often refer to countries. For example, Portuguese (Portugal) and Portuguese (Brazilian). The default locale for WordPress is English (U.S.).
  • Rosetta site: A WordPress.org clone site for a specific locale. For example the Portuguese Rosetta site is pt.wordpress.org and the Bulgarian site is bg.wordpress.org.