How to fix translation validation errors#

As part of OEP-58 (OEP-58 Overview), automatic translation validation has been added to avoid breaking builds and deployments due to invalid translations.

As of writing this document, validation scripts and GitHub Actions checks .po files for compilation errors. Other file formats are not checked, but contributions to support .json and other files validation are welcome.


  1. Monitor the list of invalid translations reports in the openedx-translations repository.

  2. Identify the invalid translation entries in the pull requests of your language by checking the bot report in the comments.

  3. Go to the openedx-translations project page.

  4. Search for the invalid translation entries in the Transifex resources.

  5. Once the issues are fixed, the Transifex bot will update the pull request and it’ll be automatically merged.