FAQ

General

What is Babelize?

Babelize is a localization platform for React, Next.js and Django apps, with Vue and static HTML in beta. Connect your GitHub repo or upload a ZIP (or run the CLI locally), select target languages, and Babelize extracts your strings, translates them and raises a PR — no manual file management needed.

Who is Babelize for?

• Indie developers shipping apps to global audiences
• Startups scaling internationally
• Teams managing multilingual applications

What frameworks does Babelize support?

Babelize supports React (JavaScript or TypeScript, including JSX/TSX; Gatsby, Remix, and Astro projects are detected as React), Next.js (with next-intl) and Django (detected via manage.py or a Django dependency): for Django, Babelize marks strings with gettext, writes .po catalogues and configures settings.py — see Django. Vue (.vue single-file components, including Nuxt) and static HTML/CSS/JS sites are in beta: they work, but expect rough edges such as untranslated strings inside <script> blocks. JavaScript and TypeScript web apps are detected via package.json, static sites via index.html. Other stacks (Laravel, Rails, Flutter, Angular, Svelte, …) are refused when you add the repository, with a message naming the framework. Angular and Svelte are on the roadmap.

How is Babelize different from Google Translate?

Pricing

Is there a free plan?

Yes. The Free plan includes 5 projects and 10,000 AI credits/month. No credit card required.

What are AI Credits?

Credits measure translation volume. 1 credit = 1 source character. Translating to multiple languages multiplies usage.

Do unused credits carry over?

No. Credits reset at each billing cycle.

Can I get a refund?

Refunds are handled case-by-case. Contact support@babelize.co for refund requests.

What plans are available?

See Billing & Plans for full details.

Translations

How accurate are the translations?

Dashboard runs use Babelize's own translator: a dictionary of common interface phrases first, then the open-source NLLB model. With your own LLM key (BYOK) you get LLM translation, which gives the best results for plurals and context. Either way, every translation is checked before it's written (placeholders, HTML tags, plural forms, glossary terms, and text returned untranslated); a string that fails is reported and retried on the next run, never shipped as the source text. Accuracy also depends on the language pair: Tier 1 languages (English, Spanish, French, German, etc.) have the highest quality. We recommend reviewing translations for critical content.

What languages are supported?

90+ languages across three tiers. See Supported Languages for the full list.

Why did my translation produce different output?

Babelize reuses existing translations (through the lockfile and Translation Memory), so unchanged strings keep their translation between runs. If output changed, check:

• Was source content modified?
• Were glossary entries updated?
• Were language settings changed?

Technical

What file formats are supported?

For React, Next.js, Vue (beta) and static HTML (beta), Babelize reads and writes JSON locale files, one per language, extracting strings from .js, .jsx, .ts, .tsx, .vue, and .html source files. Django projects use gettext .po catalogues (locale/<lang>/LC_MESSAGES/django.po), with strings extracted from .py files and Django templates; existing translations are kept and tracked .mo files are recompiled. Other locale formats (YAML, XLIFF, ARB, Markdown, iOS/Android string files) are not supported.

See File Formats for details.

How do I connect my GitHub repo?

Install the Babelize GitHub App from the project creation flow. See GitHub Integration.

Can I use my own API key for translations? (BYOK)

Yes! You can bring your own API key from OpenAI, Anthropic, Groq, OpenRouter, and Gemini. When using BYOK, credits are not consumed from your Babelize plan — you pay only for the API costs. Configure your keys in the dashboard under Settings > API Keys.

How does Translation Memory work?

Babelize stores every translation the engine produces in Translation Memory — one memory per account owner, shared across all of their projects. When a later run encounters the same or a similar source string, the stored translation is reused, reducing costs and ensuring consistency. Translation Memory is available on all plans, including Free.

What is the Glossary feature?

Glossaries let you define "never translate" terms and enforce consistent terminology across all translations. You can import/export glossaries as CSV. Glossary support is available on all plans, including Free.

How does real-time progress work?

When a Babel run is in progress, the dashboard updates in real-time via WebSocket (Socket.IO). You can see each phase as it completes, view logs, and monitor progress without refreshing the page.

What is project freeze?

If your project exceeds the usage limits of your plan (e.g., running out of AI credits), it may be frozen. Frozen projects cannot start new translations until you upgrade your plan or the freeze is lifted.

How do I set up Multi-Factor Authentication (MFA)?

You can enable MFA from your account settings. Babelize supports time-based one-time passwords (TOTP) via authenticator apps like Google Authenticator or Authy.

What background workers does Babelize use?

Babelize runs background workers: engineWorker (translation jobs), fileWorker (GitHub file operations), purgeDeletedAccounts (daily cleanup), and subscriptionExpiryWorker (hourly expiry checks). These ensure smooth operation without blocking the main application.

Getting Help

• Documentation: You're here!
• Email: support@babelize.co
• Feature requests: Submit here
• Bug reports: Report here