draw.io is a JavaScript, client-side editor for general diagramming.
Contributing Translations to draw.io
We welcome translation contributions via pull requests.
File Format
Each file is a simple key=value text file:
dia.txt- English (reference/source language)dia_{lang}.txt- Translations (e.g.dia_fr.txtfor French)
Keys must match those in dia.txt exactly. Values are the translated strings.
How to Contribute
- Fork the draw.io repository
- Edit the relevant
src/main/webapp/resources/dia_{lang}.txtfile - Submit a pull request
Adding or Updating Translations
- Use
dia.txtas the reference for all keys - Keep keys in the same order as
dia.txt - Leave a value empty if no translation is available (the app falls back to English)
- Do not add or remove keys - keys are managed in
dia.txt
Adding a New Language
Open an issue first to discuss. A new language requires:
- A new
dia_{lang}.txtfile with the same keys asdia.txt - An entry in
mxLanguageMapinsrc/main/webapp/js/diagramly/Init.js
Format Rules
- Encoding: UTF-8
- Line format:
key=value(no spaces around=) - No HTML: Use
<and>instead of<and> - Placeholders:
{1},{2}, etc. must be preserved in translations - RTL languages (Arabic, Persian, Hebrew): Wrap values with Unicode bidi markers (U+202B before, U+202C after)
- No trailing whitespace
- No blank lines between entries
Review Process
All changes are reviewed as part of the draw.io release pipeline.