How to contribute to GeoNode’s translation

Everyone is welcome to contribute to the GeoNode’s translation. There are two different ways to translate the GeoNode user interface: you can use the Transifex web application or you can edit the translation files on your local machine using Git and send Pull Requests (PR) to the GeoNode repository.

Edit translations using Transifex

The first workflow for contributing to GeoNode’s translation is by using Transifex. In this step you will see how to update the translations directly on the Transifex website.

  1. Create account

    Go to and, click Try it for free and enter the needed information to create your free account

  2. Join our project

    After activating the link you’ve got in your email, you will be asked whether you want to start a new project or to join an existing project


    Click join an existing project and type geonode into the search bar. Select the GeoNode project from the GeoNode organization (not the other ones!). You will be directed to the GeoNode project site on transifex. To join the team, click on the Join team button, then click on the language you want to add a translation in.

  3. Wait for permission to update translations from translation leader (email)

  4. Start a translation

    Click on the Translate button, then select the language where you want to add a translation


    You’ll see two main translation areas: javascript and master. Choose the one you want to add a translation and you’ll see an interface like this


    Click untranslated and add your translation like shown below


    When you stop translating, do not forget to hit the green save button at the top right!

  5. See the strings translated in GeoNode

    In order to see the strings translated in your GeoNode instance, you will need to synchronize your GeoNode instance with what it is in Transifex. For this purpose the best workflow it is to wait that a Transifex maintainer (see below section) will pull the files from Transifex, run the makemessages and compilemessages and finally send a PR to the GeoNode official repository. Or you can follow the following step, which uses github and does not require the help from a Transifex maintainer.

Translate on local machine from github

The second workflow for contributing to GeoNode’s translation is by translating the files on your local machine and send the translation to the GeoNode official repository in GitHub with pull requests.

Using this option it is assumed that you have a local Geonode GitHub repository forked.


It is recommended to first create a new branch e.g. translation in your repository for your translations.

  1. As a first step, generate all of the needed .pot files (any time the master documentation changes):

    $ cd docs
    $ sphinx-build -b gettext . i18n/pot
  2. Run the script to generate/merge (update) all of the .po files for each language:

    $ sh i18n/scripts/
  3. Do a pull from Transifex to get latest translations:

    $ tx pull -a
  4. Now edit the .po files you need, make the translations and then run the script:

    $ vi i18n/it/LC_MESSAGES/index.po
    $ sh i18n/scripts/
  5. Now you have to push the changed .po files and the appropriate .pot file (can be found in geonode/docs/i18n/pot) to your remote repository using:

    $ git commit
    $ git push
  6. Now make a pull request and GeoNode will push your changes to Transifex and include them in its official repository.

Only for transifex maintainers


This section is only for the maintainers of a transifex group!

For main Geonode localization files

These files are generated using standard django-admin tools : makemessages and compilemessages command line tools.

At first make sure to install Transifex client and configure your .transifexrc with our credentials as:

token =
password = PUTYOURPW
hostname =

To prepare the PR in your branch, execute following steps. First go to the [yourpath]/geonode/geonode/ subdirectory and get all translations from and force their replacement:

$ tx pull -a -s -f

Then update the messages in the po and compile the corresponding mo:

$ geonode makemessages --all
$ geonode makemessages -d djangojs --all
$ geonode compiliemessages

Now you can send the PR to GeoNode GitHub repository.

Finally update resources on

$ tx push -s -t

How to add a new language

To add a new language, click on Request language on the right top of the Transifex webpage.