---
id: wagtail-localize
version: "1.13.1"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# wagtail-localize — Translation plugin for Wagtail CMS

License: permissive · Maintenance: active · Downloads: 79.1K/mo

## What it is and what it does

Wagtail Localize extends Wagtail CMS with native translation capabilities, letting content editors translate pages and snippets directly in the admin interface without leaving the platform. It bridges Wagtail's internationalization framework with external translation services like Pontoon and DeepL, and supports standard PO file workflows for bulk translation management.

The plugin depends on Django, Wagtail, polib for PO file handling, and typing_extensions. Installation requires Wagtail's i18n support to be configured first, then adding the plugin to INSTALLED_APPS and running collectstatic to load admin assets. It targets modern Python (3.10–3.14) and recent Django/Wagtail versions, positioning it as a contemporary solution for multilingual Wagtail sites.

Use it for:

- Translate Wagtail pages and snippets directly in the admin UI without external tools or developer involvement.
- Integrate with Pontoon or DeepL to automate or outsource translation workflows while keeping content in Wagtail.
- Import and export translations via PO files for batch processing or integration with third-party translation management systems.
- Manage multiple language versions of a Wagtail site with a unified admin interface.
- Enable content teams to handle localization without requiring custom development or middleware.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Wagtail Localize is a translation plugin for Wagtail CMS that enables pages and snippets to be translated within the admin interface, with integrations for external translation services and PO file import/export.

Yes, if you are running Wagtail 6.3–7.2 with Django 4.2+ and need translation features. The plugin is actively maintained, has no known vulnerabilities, and low install friction. Verify that Wagtail's i18n is already configured and that external service integrations (if needed) align with your workflow before committing.

## Install

pip install wagtail-localize
uv add wagtail-localize
poetry add wagtail-localize

## Installing wagtail-localize

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release (86 days ago) and steady commit activity. Requires Wagtail with internationalization already enabled and Django 4.2 or later.

License in practice: BSD-3-Clause is a permissive open-source license allowing commercial and private use with minimal restrictions, making it safe for most projects.

Quickstart:

pip install wagtail-localize

# In settings.py INSTALLED_APPS:
INSTALLED_APPS = [
    "wagtail_localize",
    "wagtail_localize.locales",
]

python manage.py collectstatic

Wagtail internationalization must be enabled first per Wagtail's configuration guide; requires Python 3.10+, Django 4.2+, and Wagtail 6.3–7.2.

Verify before relying:

- Whether external service integrations (Pontoon, DeepL) require additional configuration or API keys beyond the plugin installation.
- Performance characteristics when translating large numbers of pages or snippets.
- Whether wagtail-modeladmin dependency is automatically installed or must be added separately for Wagtail >= 6.3.

## Package facts

- License: BSD-3-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 79.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

wagtail translation plugin, cms multilingual content, wagtail i18n localization, translate wagtail pages, po file translation import, pontoon deepl wagtail, wagtail admin translation, wagtail-plugin, translation-localization, content-management

[View on SkillFed](https://skillfed.io/packages/wagtail-localize) · [View on PyPI](https://pypi.org/project/wagtail-localize/)