Installation guide

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

Install the Python package

Firstly install wagtial-localize Python package.

If you are using pip, use the following command:

pip install wagtail-localize

Add to INSTALLED_APPS

Now add wagtail_localize to your INSTALLED_APPS setting:

INSTALLED_APPS = [
    ...
    "wagtail_localize",
    ...
]

Enabling the "Sync from" field (optional)

Wagtail Localize has a feature that allows you to automatically synchronise language trees. This means that any new pages created in a source language are automatically created as an alias in another language.

The locales that are synchronised from others can be managed through the Wagtail admin interface.

To enable this, replace the "wagtail.locales" entry in INSTALLED_APPS with "wagtail_localize.locales", this will add a "Sync from" field to all locales that allows an administrator to choose a locale to synchronise content from.

Disabling the default translation mode

Wagtail Localize will automatically go in translation mode when creating new translations for models.

To disable this behaviour globally, set WAGTAIL_LOCALIZE_DEFAULT_TRANSLATION_MODE = "simple" in your settings file. If you wish to disable it per page or model type, set the localize_default_translation_mode attribute to "simple" on your model. The default value is synced.

e.g.

class MyPage(Page):
    localize_default_translation_mode = "simple"
    # ...