Introduction to translating site interfaces

Last updated on
11 March 2021

Drupal 7 will no longer be supported after January 5, 2025. Learn more and find resources for Drupal 7 sites

This documentation needs work. See "Help improve this page" in the sidebar.

When enabled, Locale module allows you to present your Drupal site in a language other than the default (English).

You can use it to set up a multilingual web site or to replace the elements of the interface text with text which has been customized for your site. Whenever the module encounters text, it tries to translate it into the currently selected language. If a translation is not available, the string is remembered, so you can look up untranslated strings easily.

The Localization Update module can automatically retrieve translations from http://localize.drupal.org. For languages where translation has already been done, you do not have to do anything other than set up this module. In Drupal 7 (and previous versions), the Localization Update module is a contributed module. For Drupal 8, it is part of core.

The Locale module provides two options for providing translations. The first is the integrated web interface, which you can use to search for untranslated strings and to specify their translations. An easier and less time-consuming method is to import existing translations for your language. These translations are available as GNU gettext Portable Object files (.po files for short). You can download translation files from the Drupal translations server.

If an existing translation does not meet your needs, the .po files are easily edited with special editing tools. The Locale module's import feature allows you to add strings from such files into your site's database. The export functionality enables you to share your translations with others, generating Portable Object files from your site's strings.

Note: Enabling the Locale module itself does not create or add any translations to the site. You need to import translations or create string translations by using Translate Interface option (provided by the Content Translation module from Drupal core for Drupal 6 onwards).

Note that if you are creating a website with right-to-left text direction, you'll need a theme which supports this, like the Garland core theme.

For more useful materials on configuring a multilingual site in Drupal, see Resource Guide: Configuring a Multilingual Site.

Drupal 7 and later

You can:

  1. Administer languages: http://example.com/admin/config/regional/language
  2. Manage strings for localization: http://example.com/admin/config/regional/translate
  3. Specify how the desired languages are detected: http://example.com/admin/config/regional/language/configure
    or Configuration → Regional and language → Detection and selection
  4. Translate strings: http://example.com/admin/config/regional/translate/translate
  5. Import strings: http://example.com/admin/config/regional/translate/import
  6. Export strings: http://example.com/admin/config/regional/translate/export

Prior to Drupal 7

You can:

  • Administer languages: Administer → Site configuration → Languages
  • Manage strings for the localization: Administer → Site building → Translate interface

Also read about the security implications of translations from localize.drupal.org.

Help improve this page

Page status: Needs work

You can: