Before you start, follow Wagtail's configuration guide to enable internationalisation in Wagtail and Django.
Install the Python package
wagtial-localize Python package.
If you are using
pip, use the following command:
pip install wagtail-localize
wagtail_localize to your
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
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
on your model. The default value is
class MyPage(Page): localize_default_translation_mode = "simple" # ...