Tag Protect tool
The Tag Protect tool finds tags and placeholders in source text using regular-expression patterns and records them as an annotation on the block, along with a count property. Downstream tools — for example an MT or AI translation step — can then read the annotation to preserve those tokens rather than translating or reformatting them.
When no patterns are configured, a built-in default set is used, covering
HTML/XML tags, curly-brace placeholders (ICU, Java, .NET), printf-style
placeholders, and ${...} template expressions. The tool records what it
found; preserving the matches is the job of the consuming tool.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
patterns | string[] | Regex patterns for tags and placeholders to protect |
Configure these parameters interactively and copy the flow-step YAML on the Tool Reference.
Examples
Protect the default token set
Use built-in patterns for tags and common placeholders.
patterns: []
Protect only HTML tags
Restrict protection to markup tags.
patterns: - "<[^>]+>"
Processing notes
Operates on translatable blocks only; non-translatable blocks pass through unchanged.
Matches are recorded as a block annotation and the match count as a block property; matches are deduplicated and ordered by offset.
Limitations
Patterns use Go's RE2 syntax, which does not support backreferences or lookaround.
The tool records protected matches as an annotation; it does not itself prevent their modification.
← Back to the Tool Reference