VS Code Extension available! Install nowTranslate YAML files online
Upload your .yml files to SimpleLocalize, add languages, auto-translate and download one .yml file per language in seconds.
hello-world: Hello World!
nested:
translation:
key: Nested translation key
other:
translation:
key:
supported: Look this is also supported!What is the YAML format?
YAML translation files use indentation instead of braces, which makes them easy to read and diff. Ruby on Rails, Symfony and many static site generators keep their locale files in YAML.
It is used by Ruby on Rails, Symfony, Jekyll, Hugo. SimpleLocalize reads and writes it natively, so you keep your existing project structure. Format value for the CLI and API: yaml. Read the format documentation.
How to translate YAML files
- Create a free account and a project. The Community plan covers small apps with no credit card.
- Import your .yml file in the web editor, or push it from the terminal with the CLI.
- Add target languages and run auto-translation. Use DeepL or Google Translate for speed, or OpenAI, Claude and Gemini with your own API key for context-aware translations.
- Review in the editor with QA checks, glossary and screenshots, then download the YAML files or publish them to the translation hosting CDN.
Sync YAML files from CI
Add a simplelocalize.yml to the repository and run simplelocalize upload and simplelocalize download in your pipeline or GitHub Action:
# simplelocalize.yml
apiKey: YOUR_PROJECT_API_KEY
uploadFormat: yaml
uploadPath: ./locales/{lang}.yml
downloadFormat: yaml
downloadPath: ./locales/{lang}.ymlConvert YAML to other formats
The same project can export translations in more than 30 formats, and the free online converter works without an account:
Start translating YAML files
- Native YAML import and export
- Auto-translation with DeepL, Google, OpenAI, Claude and Gemini
- Translation editor, QA checks, CLI and CDN on the free plan