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.