Translation Comparison tool
The Translation Comparison tool compares the translations of a block in two target locales (or two versions) and records the result on the block's properties: a status — identical, different, or one of the missing-translation cases — and a human-readable diff description. When a translation is absent for one or both locales, the status reflects which side is missing.
Comparison sensitivity is configurable: case, whitespace, and punctuation can each be ignored so that cosmetic differences do not register as a mismatch. The two locales being compared are supplied programmatically; the parameters below control how the comparison is performed and how the translations are labelled in the report.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
caseSensitive | boolean | true | Take case differences into account when comparing |
document1Label | string | Trans1 | Label for the first translation in reports |
document2Label | string | Trans2 | Label for the second translation in reports |
genericCodes | boolean | true | Use generic numbered tags (e.g. <1>...</1>) instead of original inline codes in reports |
punctuationSensitive | boolean | true | Take punctuation differences into account when comparing |
whitespaceSensitive | boolean | true | Take whitespace differences into account when comparing |
Configure these parameters interactively and copy the flow-step YAML on the Tool Reference.
Examples
Ignore cosmetic differences
Treat translations that differ only in case, whitespace, or punctuation as identical.
caseSensitive: false whitespaceSensitive: false punctuationSensitive: false
Label the compared translations
Use meaningful labels for the two translations in the diff output.
document1Label: Vendor A document2Label: Vendor B
Processing notes
Operates on translatable blocks; non-translatable structure passes through unchanged.
The two locales to compare are configured programmatically, not through the parameters above.
Limitations
Compares two target locales of the same block; it does not compare against an external reference file.
A block is only compared when it carries translations for the configured locales; otherwise a missing-translation status is recorded.
← Back to the Tool Reference