WordPress Localization

Running a content operation across multiple locales takes platform-level work before any content is localized for individual markets. On an enterprise WordPress platform, localization builds a dedicated set of components for each locale. Technical decision-makers and web architects use WordPress localization to configure locale files, including language strings, formats, and .po/.mo assets.

What is WordPress localization?

WordPress localization is the process of creating and configuring the platform’s strings, formats, and locale files for a given region. This process happens before content translation. It adapts the WordPress UI, theme, and plugin strings, along with date, time, and currency format rules. WordPress localization matters most when a site serves more than one language.

What is internationalization in WordPress localization?

Internationalization is a set of prerequisite changes to the codebase that make WordPress localization possible. This includes text-domain registration, gettext-wrapper preparation, and translatable-string marking. WordPress internationalization prepares the codebase, while localization adapts it. Correctly implementing internationalization makes adding a new locale a simple configuration task.

Localization files: POT, PO, and MO

WordPress localization files are a combination of POT, PO, and MO assets. Each file type has a distinct role across the workflow, progressing from template, to translation, to compiled binary. Gettext produces upstream files including POT and PO assets. The MO binary is the localization file WordPress loads at request time.

POT files

A Portable Object Template (POT) file is the source-language template that gettext generates from a WordPress codebase. The template contains msgid lines for every translatable string written in the code. This file omits actual translations, which are stored in PO files.

PO files

PO files are the locale-specific translation files derived from POT templates. Each Portable Object (PO) file is the middle stage of the localization process. Each file targets a single locale, pairing the inherited msgid text with msgstr lines a translator fills. A translator edits this human-readable plain text file directly to update strings before tools produce the final format.

MO files

WordPress uses compiled binary MO files during runtime lookup. Gettext compiles this Machine Object to provide fast lookup at request time. The runtime file is stored in the WordPress wp-content/languages directory. This format completes the process where POT defines, PO translates, and MO loads.

The WordPress localization workflow

The WordPress localization workflow is a three-step sequence required to localize enterprise platforms. Gettext extraction tools generate POT template files from the codebase. A human or machine translator adapts strings within the PO file for each target locale. Once translation is complete, a tool like msgfmt compiles the data into an MO binary deployed to wp-content/languages. For enterprise content localization, this sequence supports workflow governance, including version control and audit trails.

WordPress localization plugins

WordPress localization plugins simplify these workflows. They manage platform files along with theme and plugin strings. Polylang, WPML, and Loco Translate are three common plugins used in WordPress localization workflows. The table below highlights the primary scope and licensing model of each plugin.

Polylang

Polylang is a WordPress localization plugin. It covers theme and plugin string translation and coordinates locale switching at the WordPress level.

Primary scope

Theme and plugin strings

License model

Open source & commercial

Locale-asset focus

Locale-switch coordination

WPML

WPML is a WordPress localization plugin. It handles string translation and locale management at the WordPress level, and its commercial license adds broader content-translation features beyond localization.

Primary scope

Theme, plugin, and platform text

License model

Commercial

Locale-asset focus

String-translation surface

Loco Translate

Loco Translate is a WordPress localization plugin operating directly at the file-format layer. The plugin supports PO file editing from wp-admin, exposing the underlying msgid and msgstr fields. Polylang, WPML, and Loco Translate take different approaches to WordPress localization, so development teams can choose the tool that matches their workflow.

Primary scope

In-admin file editing

License model

Open source & freemium

Locale-asset focus

In-place PO compilation

Localization best practices

Localization adapts format conventions to each locale: date and time formats, currency conventions, and name and address forms. Global deployment requires a translation review workflow to validate content for cultural relevance. Engineering teams use CMS localization to establish platform-neutral standards. Enterprise website localization strategy includes governance via role-based access controls that dictate which users can modify localization assets. Delivering that content in each language is a separate layer, handled by a multilingual CMS. WordPress workflow automation keeps localization consistent across the content lifecycle. Thorough QA per locale helps achieve consistency.

WordPress localization files at runtime

Once deployed, WordPress loads these localization files at runtime. Compiled MO files live in wp-content/languages, and WP core loads them automatically when a page is requested to render translated strings. Site admins set the active locale through the Site Language option in Settings → General. Older installations may still define the WPLANG constant in wp-config.php, but WordPress deprecated that constant in version 4.0 and now ignores it. The platform completes asset registration by mapping each text domain through load_plugin_textdomain or load_theme_textdomain. Deploying locale files is distinct from delivering translated content per language, which a WordPress multilingual setup handles.

Frequently asked questions

What’s the difference between internationalization and localization in WordPress?

Internationalization is the developer work that prepares your codebase to support translation, things like wrapping strings in gettext functions and registering a text domain. Localization generates the actual PO/MO files for each target locale. You can’t localize a plugin or theme that hasn’t been internationalized first.

Do I need a separate MO file for every locale?

Yes. Each locale gets its own PO file (the human-edited translation) compiled into its own MO file (the binary file WordPress actually loads). A site serving ten locales needs ten MO files in wp-content/languages, each mapped to its text domain via load_plugin_textdomain or load_theme_textdomain.

Can I edit PO files directly, or do I need a plugin?

You can edit PO files directly in any text editor, then compile them to MO with a command-line tool like msgfmt. Plugins like Loco Translate exist to make that easier by letting you edit and compile PO files from inside wp-admin, without touching the command line or file system directly.

Is WordPress localization the same as running a multilingual site?

No. Localization configures WordPress’s own UI, formats, and system strings for a region. Running a multilingual site, showing visitors different content in different languages, is a separate content-management layer, usually handled by a plugin or customization built on top of a properly localized WordPress install.

What happens to translations when developers add new strings?

New or changed strings require regenerating the POT template from the updated codebase, then merging it into each locale’s existing PO file with a tool like msgmerge. Merging preserves translations already in place and marks new strings as untranslated, so translators only review what changed. Each updated PO file is then recompiled to MO and redeployed. Extraction and merging can be automated in CI, which leaves translation as the only manual step.