Introduction
Getting Started
Get up and running with Mergua in minutes. Create a project, upload your translation files, invite your team, and start translating.
1. Create your account
Sign up with your email. You'll get a verification link — click it and you're in. Your first organization is created automatically.
2. Create a project
Click New project on the Projects page. Give it a name, pick your source language (e.g. English), and hit create. Mergua generates a slug from the name — you'll use it in CLI commands and API calls.
3. Add your translation keys
You have two ways to add keys:
- Upload a JSON file — drop your existing source file (e.g.
en.json) into the upload area. Mergua imports all keys with their values. Both flat and nested JSON are detected automatically. - Add keys manually — use the translation editor to create keys one by one. Useful for adding individual strings.
See Import & Export for the full upload and download options.
4. Add target languages
Open your project and add the languages you want to translate into. Mergua supports 100+ locales. Each added language gets empty translations for all your keys.
5. Invite your team
Go to the Team page and invite translators by email. Assign them the Translator role so they can add and review translations.
6. Translate
Open the translation editor by clicking a language on the project page. You'll see the source text on the left and the translation input on the right. Use AI Translate to auto-fill missing translations, then review and adjust.
7. Download or sync
Once translations are ready, download them as JSON files — individual locales or all at once as a ZIP. For automated workflows, set up Pipeline Sync to pull translations directly into your CI/CD pipeline.