Localization

Locales and Languages Supported by Facebook

Languages on Facebook use the format ll_CC, where ll is a two-letter language code, and CC is a two-letter country code. For instance, en_US represents U.S. English. We support many ISO languages and country codes

There are two exceptions that do not follow the ISO standard: ar_AR and es_LA. We use these to denote umbrella locales for Arabic and Spanish. For Spanish, we support a few specialized localizations.

Localization with Social Plugins and JavaScript SDK

One of the most basic ways to integrate a website or an app with Facebook is to add Social Plugins. This includes Like, Recommend and other buttons that let people easily interact with your web page or app.

When you do this, Facebook can automatically translate the text for the plugin in a local language through the Facebook JavaScript SDK. The SDK is available in all locales supported by Facebook.

To take advantage of automatic social plugin translation, you need to change the locale of the SDK to match the locale of your site. Specifically, you need to change en_US to a supported locale code when loading the SDK's source.

For example, if your app or site is in Spanish, using the following code to load the SDK will cause all Social Plugins to be rendered in Spanish.

(function(d){
  var js, id = 'facebook-jssdk'; if (d.getElementById(id)) {return;}
  js = d.createElement('script'); js.id = id; js.async = true;
  js.src = "https://connect.facebook.net/es_LA/all.js";
  d.getElementsByTagName('head')[0].appendChild(js);
}(document));

Note that this only applies to plugins and buttons that are directly integrated with your site. Dialog such as the Login Dialog render in the language that the person has picked as their native language on Facebook, even if it's different than the language you select.

App Center and Localization

If your app is a game you can make your app appear in the Facebook App Center. For localizing your Facebook App Center page, please read the section App Center Page Localization.