There are a few settings which can be used to configure wagtailtrans to suit your needs, these settings need to be configured in your django settings module. All wagtailtrans settings are prefixed with WAGTAILTRANS_ to avoid conflicts with other packages used.



If set to False wagtailtrans will work with Freeform trees.

See also

The documentation about Synchronized translation trees

See also

The documentation about Freeform translation trees



If set to True wagtailtrans will allow you to define a default language and additional languages per site. This is mostly used in a multi site setup and allowes you to define the languages per site, this way they can differ for all available sites.


When using Django’s loaddata wagtailtrans detaches all signals so there aren’t any weird side-effects triggered when loading your data. However using loaddata in combination with WAGTAILTRANS_LANGUAGES_PER_SITE there is still one signal which can’t be detached m2m_changed to do this you can provide the environment variable WAGTAILTRANS_DISABLE_SIGNALS=True to your loadddata command, this will skip adding the signals as well.


WAGTAILTRANS_DISABLE_SIGNALS=True ./ loaddata data.json


Using WAGTAILTRANS_DISABLE_SIGNALS can potentially break your complete wagtailtrans installation, when used incorrectly.



If set to True the CMS user will only see the tree of the canonical language, with an edit in button where they can choose the language to edit the page in.