Help
FAQ
Answers to common questions about Mergua — from getting started to billing.
General
Mergua is a translation management platform for single-page applications. It lets you upload translation files, invite team members to collaborate, and download translations in various formats — via the UI or an API.
Mergua works with any SPA that uses JSON-based translation files. It has first-class support for Angular with Transloco, but works equally well with React (i18next, react-intl), Vue (vue-i18n), and other frameworks.
No. Mergua is a web application — just sign up and start managing translations in your browser. For CI/CD integration, you only need curl to pull translations in your pipeline.
Projects & Keys
A project maps to one application or library. Each project has its own set of translation keys, locales, branches, and API keys.
You can add keys manually in the UI or import them from a JSON file. The import detects flat and nested JSON formats automatically.
Mergua supports flat JSON and nested JSON for both import and export. You can download individual locales or all locales at once as a ZIP archive.
Branches
Branches let you work on translations in isolation — just like Git branches. Create a branch from main, make changes, review the diff, and merge back when ready.
When you use Pipeline Sync, Mergua can automatically match your Git branch to a Mergua branch with the same name. This way, each feature branch gets the right translations during CI builds.
Merging applies all translation changes from the branch to main. If there are conflicts (the same key was changed on both sides), Mergua shows a diff so you can resolve them before merging.
AI Translation
You can translate individual keys or batch-translate all missing translations with one click. AI results are always saved as drafts so a human can review and approve them.
Yes. Each plan includes a monthly quota of AI translations. The Free plan includes 50 per month, Pro includes 1,000, and Business offers unlimited AI translations.
Pipeline Sync
Pipeline Sync lets you pull translations into your CI/CD pipeline automatically. Add a curl command to your build script, and translations are downloaded fresh on every build.
No — just curl. The sync endpoint returns a shell script that handles downloading, branch matching, and key sync. See the Pipeline Sync docs for the exact command.
Key Sync compares the keys in your local source file with the keys in Mergua and automatically adds new keys or removes deleted ones. This keeps your translation files and Mergua in sync without manual work.
Team & Permissions
Go to the Team page and invite members by email. They receive an invitation link and can join your organization after signing up or logging in.
Mergua has three roles: Owner (full access including billing and settings), Translator (can edit translations and branches), and Viewer (read-only access).
Plans & Billing
The Free plan lets you explore the core product. Branches, API access, and review workflow are available on Pro and Business plans.
You'll see a notification when approaching limits. Existing data is never deleted — you just can't add new items until you upgrade or free up space.
Yes, you can downgrade at any time from Organization Settings. The downgrade takes effect at the end of the current billing period. If your usage exceeds the lower plan limits, you will need to reduce usage before the downgrade activates.
Go to Organization Settings and click Cancel subscription. Your paid features remain active until the end of the current billing period, then your organization reverts to the Free plan.
Invoices are available through the Stripe customer portal, accessible from Organization Settings.
Still have questions?
Reach out to us at support@mergua.com