Length Check tool
The Length Check tool verifies that each translation stays within configured length constraints and records any findings on the block's properties as QA issues. It supports three kinds of limit: absolute caps on character or word count; a simple maximum/minimum percentage of source length; and a long/short ratio model that applies different percentage thresholds depending on whether the source text is above or below a character breakpoint. A target locale is required; blocks without a translation are skipped.
Each limit can be enabled independently, and any limit set to 0 is disabled.
The long/short ratio model mirrors the length-checker defaults used by the
Okapi Framework bridge, so its thresholds line up with the equivalent bridge
step.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
checkMaxCharLength | boolean | true | Warn if target exceeds a percentage of source character length |
checkMinCharLength | boolean | true | Warn if target is shorter than a percentage of source character length |
maxCharLengthAbove | integer | 200 | Max percentage of source length allowed for long text |
maxCharLengthBelow | integer | 350 | Max percentage of source length allowed for short text |
maxCharLengthBreak | integer | 20 | Character count threshold between short and long text for max check |
maxChars | integer | 0 | Absolute maximum character count for target text (0 = disabled) |
maxPercentage | number | 0 | Maximum target/source length ratio as percentage (0 = disabled) |
maxWords | integer | 0 | Maximum word count for target text (0 = disabled) |
minCharLengthAbove | integer | 45 | Min percentage of source length allowed for long text |
minCharLengthBelow | integer | 30 | Min percentage of source length allowed for short text |
minCharLengthBreak | integer | 20 | Character count threshold between short and long text for min check |
minPercentage | number | 0 | Minimum target/source length ratio as percentage (0 = disabled) |
Configure these parameters interactively and copy the flow-step YAML on the Tool Reference.
Examples
Cap absolute character length
Flag any translation longer than 80 characters, useful for fixed-width UI strings.
maxChars: 80
Constrain target/source ratio
Require the target to be between 30% and 200% of the source length.
minPercentage: 30 maxPercentage: 200
Processing notes
Operates on translatable blocks; non-translatable structure passes through unchanged.
Findings are stored on the block as a JSON array of QA issues.
Limitations
Percentage and ratio checks compare character lengths only when the source is non-empty.
Requires a configured target locale; blocks without a translation for it are skipped.
← Back to the Tool Reference