Help

FAQ

Answers to common questions about Mergua — from getting started to billing.

General

What is Mergua?

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.

Which frameworks does Mergua support?

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.

Do I need to install anything?

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

What is a project in Mergua?

A project maps to one application or library. Each project has its own set of translation keys, locales, branches, and API keys.

How do I add translation 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.

What file formats can I import and export?

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

What are branches in Mergua?

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.

Do Mergua branches sync with my Git branches?

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.

What happens when I merge a branch?

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

How does AI translation work?

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.

Are AI translations counted against a limit?

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

What is 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.

Do I need a special tool for Pipeline Sync?

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.

What is Key Sync?

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

How do I invite team members?

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.

What roles are available?

Mergua has three roles: Owner (full access including billing and settings), Translator (can edit translations and branches), and Viewer (read-only access).

Plans & Billing

Can I try paid features before upgrading?

The Free plan lets you explore the core product. Branches, API access, and review workflow are available on Pro and Business plans.

What happens if I exceed my plan limits?

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.

Can I downgrade my plan?

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.

How do I cancel my subscription?

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.

Where can I find my invoices?

Invoices are available through the Stripe customer portal, accessible from Organization Settings.

Still have questions?

Reach out to us at support@mergua.com