The localazy batch command groups operations that act on many phrases at once for a given language. They are processed asynchronously on the server — the CLI starts the operation, polls for progress, and reports the final result once it finishes.

There are three subcommands:

Subcommand Purpose
localazy batch translate Machine-translate phrases for a target language using a chosen MT engine.
localazy batch approve Approve waiting versions of translations for a target language.
localazy batch intm Apply translation memory (InTM) from connected projects.

If you only need a one-off translation that is not stored on Localazy, use localazy translate instead.

Authorization #️⃣

All batch operations use the project’s writeKey and require the MANAGER or OWNER role. See Authorization for details on configuring keys.

All subcommands accept the --branch NAME option to operate on a specific branch.

Server-side operations #️⃣

All operations are processed asynchronously on the server side. While the CLI waits for the operation to finish, the operation is not terminated or suspended if the CLI is interrupted.

Common options #️⃣

These options are accepted by multiple batch subcommands. Per-subcommand sections below describe which ones apply where.

Option Description
--lang LOCALE Required. Target language locale code (e.g. cs, de, fr).
--phrases IDS Comma-separated phrase IDs to limit the operation to, or all (default).
--branch NAME Run against a specific branch.

Batch translate #️⃣

Translate phrases for a target language using one of the supported AI/MT engines.

localazy batch translate --lang cs --engine localazyAi

By default, only phrases with no translation in the target language are processed. Use the flags below to include other categories.

Options #️⃣

Option Default Description
--lang LOCALE required Target language locale code.
--engine ENGINE required MT engine. Allowed values: google, amazon, azure, deepl, localazyAi.
--approve false Auto-approve the new translations instead of placing them in review.
--source-changed false Also translate phrases that already have a translation but whose source string has changed.
--waiting-for-review false Also translate phrases that have a version waiting for review.
--source-lang LOCALE - Override the source language used for translation. By default, project’s source language is used.
--phrases IDS all Comma-separated phrase IDs to translate, or all.

Engines #️⃣

ID Engine
localazyAi Localazy AI (recommended)
google Google Translate
amazon Amazon Translate
azure Azure Translator
deepl DeepL

All AI/MT engines consume translation credits from your project’s plan. Use localazy batch intm first if you have connected projects with reusable translations.

Examples #️⃣

Translate all untranslated Czech phrases with Localazy AI and put translations into review:

localazy batch translate --lang cs --engine localazyAi

Translate and immediately approve German translations using DeepL:

localazy batch translate --lang de --engine deepl --approve

Translate all untranslated phrases and those with the source changed flag:

localazy batch translate --lang fr --engine localazyAi --source-changed

Batch approve #️⃣

Approve translations waiting for review for a given language.

localazy batch approve --lang cs

By default, the latest waiting version of each phrase is approved. Use --type to control which versions are eligible and which one is preferred.

Options #️⃣

Option Default Description
--lang LOCALE required Target language locale code.
--type FILTER:SELECTION all:latest Which versions are eligible (filter) and which one is preferred (selection). See Approval types below.
--all-versions true Process all versions, not only unapproved ones.
--process-approved false Re-approve already approved translations.
--phrases IDS all Comma-separated phrase IDs to approve, or all.

Approval types #️⃣

The --type option uses the form FILTER:SELECTION.

FILTER controls which versions are considered for approval:

Filter Description
all All versions, regardless of source.
human Only versions submitted by human translators.
clt Only versions submitted by Localazy CLT.

SELECTION controls which of the eligible versions wins when more than one is available:

Selection Description
single Approve only when there is exactly one waiting version (skip phrases with multiple).
latest Pick the latest version.
human Prefer the version from a human translator.
clt Prefer the version from CLT.

The default all:latest approves the latest available version for every phrase that has at least one waiting version.

Examples #️⃣

Approve the latest waiting version of every Czech translation:

localazy batch approve --lang cs

Approve only translations submitted by human translators, picking the latest:

localazy batch approve --lang de --type human:latest

Approve only phrases that have a single unambiguous waiting version:

localazy batch approve --lang fr --type all:single

Batch InTM #️⃣

Apply translation memory (InTM) from connected projects to phrases in the target language. InTM reuses approved translations across your projects and does not consume any credits — it is the cheapest way to get coverage on phrases that have been translated elsewhere.

localazy batch intm --lang cs

By default, all connected projects are eligible as TM sources. Use the options below to narrow down which projects are used.

Options #️⃣

Option Default Description
--lang LOCALE required Target language locale code.
--approve false Auto-approve the new translations instead of placing them in review.
--source-projects IDS — Comma-separated connected project IDs to use as TM source.
--all-sources false Use all connected projects as TM source.
--external-only false Exclude the current project from the TM source list.
--waiting-for-review false Also process phrases that have a version waiting for review.
--phrases IDS all Comma-separated phrase IDs to process, or all.

Examples #️⃣

Apply translation memory from all connected projects to Czech:

localazy batch intm --lang cs --all-sources

Apply TM from specific connected projects only:

localazy batch intm --lang de --source-projects _a7899421261323541,_a984121546213546546

Apply TM, excluding the current project (useful when you only want matches that come from external sources):

localazy batch intm --lang fr --all-sources --external-only

Exit codes #️⃣

Batch commands return a non-zero exit code if the operation fails to start, the server reports an error, or the result includes errors that prevent completion.