FAQ

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.

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 reads and writes flat JSON, nested JSON, ARB and XLIFF 2.0. You can download individual locales or all locales at once as a ZIP archive — except XLIFF, where a document is one language pair, so it is one language at a time.

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.

You can translate individual keys or batch-translate all missing translations with one click. AI results are saved as translated but not reviewed, so a reviewer still approves them. A result that dropped a placeholder, ran over the character limit or did not keep a protected term is saved as a draft instead.

Yes. Each plan includes a monthly quota of AI translations. The Free plan includes 50 per month, Starter 300, Pro 2,000 and Business 10,000.

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.

Yes. Give a project a webhook URL and Mergua POSTs to it when translations change or a branch is merged, so your pipeline starts instead of polling on a schedule. Every delivery is signed with a secret you can verify, and the payload names what changed — the branch, the language and the file — while your pipeline pulls the files themselves. Webhooks come with API access, from Starter, since that pull goes through the API.

Open Organization settings from the organization menu in the top bar, go to the Members tab and choose Invite member — owners only. They receive an invitation link and can join your organization after signing up or logging in.

Mergua has four roles: Owner (full access including billing and settings), Maintainer (approves, rejects and merges, but no billing, members or project settings), Translator (can edit translations and branches), and Viewer (read-only access).

The Free plan lets you explore the core product. API access, the sync script, MCP and webhooks start on Starter; branches and the review workflow are available on Pro and Business.

Yes. Pro and Business can be billed yearly at a lower price per month, and the pricing page shows the saving. You can switch in either direction from the billing portal; a yearly plan cancelled midway stays active until the year you paid for ends.

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.