Wagtail localize

Wagtail Localize is a translation plugin for the Wagtail CMS. It allows pages or snippets to be translated within Wagtail's admin interface. It also provides integrations with external translations services such as Pontoon or DeepL, and importing/exporting translations with PO files.

Documentation Changelog

Requirements

Wagtail Localize requires the following:

Python (3.10, 3.11, 3.12, 3.13, 3.14)
Django (5.2, 6.0, 6.1)
Wagtail (7.0, 7.4 and 8.0) with internationalisation enabled
wagtail-modeladmin if using wagtail_localize.modeladmin

Installation

Before you start, follow Wagtail's configuration guide to enable internationalisation in Wagtail and Django.

Install using pip:

pip install wagtail-localize

Add wagtail_localize and wagtail_localize.locales to your INSTALLED_APPS setting:

INSTALLED_APPS = [
    # ...
    "wagtail_localize",
    "wagtail_localize.locales",  # This replaces "wagtail.locales"
    # ...
]

wagtail-localize loads additional assets for the editing interface. Run the collectstatic management command to collect all the required assets.

python manage.py collectstatic

Contributing

All contributions are welcome!

Install

To make changes to this project, first clone this repository:

git clone git@github.com:wagtail/wagtail-localize.git
cd wagtail-localize

With your preferred virtualenv activated, install testing dependencies:

Using pip

pip install "pip>=21.3"
pip install -e '.[testing]' -U

Using flit

pip install "flit>=3.8.0"
flit install

pre-commit

Note that this project uses pre-commit. To set up locally:

# go to the project directory
$ cd wagtail-localize
# initialize pre-commit
$ pre-commit install

# Optional, run all checks once for this, then the checks will run only on the changed files
$ pre-commit run --all-files

How to run tests

Now you can run tests as shown below:

tox

or, you can run them for a specific environment tox -e python3.13-django5.2-wagtail7.0 or specific test tox -e python3.13-django5.2-wagtail7.0-sqlite -- tests.test_edit_translation.TestGetEditTranslationView

To run the test app interactively, use tox -e interactive, visit http://127.0.0.1:8020/admin/ and log in with admin/changeme.

Support

For support, please use GitHub Discussions or ask a question on the #multi-language channel on Wagtail's Slack instance.

Thanks

Many thanks to all of our supporters, contributors, and early adopters who helped with the initial release. In particular, to The Mozilla Foundation and Torchbox who sponsored the majority of the initial development and Wagtail core's internationalisation support.

Release files for wagtail-localize 1.14.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wagtail-localize 1.14.5
File	Size	Uploaded
wagtail_localize-1.14.5.tar.gz	1.2 MB	Aug 19, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for wagtail-localize 1.14.5
File	Interpreter	ABI	Platform	Reset
wagtail_localize-1.14.5-py3-none-any.whl 535.3 kB Aug 19, 2026	Python 3	none	any	Details

Total release size: 1.7 MB

Release files / wagtail_localize-1.14.5.tar.gz

Download URL	wagtail_localize-1.14.5.tar.gz
Size	1.2 MB
Tags	Source
SHA-256 checksum How to use checksums	`7e21bb845bd0142a554a8ddb5819450782107dac94756a90f56085991a4c318d`
BLAKE2b-256 checksum How to use checksums	`5009edc4a6a17edcdf78d2a5bf8395e68f991c709d101aad0ce4fc636b0f9ef0`
Upload date	Aug 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/wagtail/wagtail-localize
Publishing commit: github.com/wagtail/wagtail-localize/tree/cb4b4ed7871d88ee09cce51a04242bff93f28520

Workflow

Publishing configuration: github.com/wagtail/wagtail-localize/blob/cb4b4ed7871d88ee09cce51a04242bff93f28520/.github/workflows/publish.yml
Publishing logs: github.com/wagtail/wagtail-localize/actions/runs/32268443016/attempts/1

Artifact

Subject: wagtail_localize-1.14.5.tar.gz
SHA-256 checksum: 7e21bb845bd0142a554a8ddb5819450782107dac94756a90f56085991a4c318d Verifying attestations

Release files / wagtail_localize-1.14.5-py3-none-any.whl

Download URL	wagtail_localize-1.14.5-py3-none-any.whl
Size	535.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c08841d1d982e238b4cf5fb8e5d4cace82cf8e8d255fd0db4fa11dd874d7c0fd`
BLAKE2b-256 checksum How to use checksums	`276459c70f0c48e37bcec2706963adbe5a577e178bdf56790f10e581ffff8f35`
Upload date	Aug 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/wagtail/wagtail-localize
Publishing commit: github.com/wagtail/wagtail-localize/tree/cb4b4ed7871d88ee09cce51a04242bff93f28520

Workflow

Publishing configuration: github.com/wagtail/wagtail-localize/blob/cb4b4ed7871d88ee09cce51a04242bff93f28520/.github/workflows/publish.yml
Publishing logs: github.com/wagtail/wagtail-localize/actions/runs/32268443016/attempts/1

Artifact

Subject: wagtail_localize-1.14.5-py3-none-any.whl
SHA-256 checksum: c08841d1d982e238b4cf5fb8e5d4cace82cf8e8d255fd0db4fa11dd874d7c0fd Verifying attestations