Skip to main content

Search and Replace tool

The Search and Replace tool performs find-and-replace on block text. The search/replace pairs themselves are supplied programmatically or by the configured command; the schema-visible options here control matching behaviour — literal versus regular-expression mode, case sensitivity, and whether the replacement scans source, target, or both.

When regular-expression mode is on, the case, dot-all, and multiline flags are applied to every pattern. By default the tool replaces all matches in target text only.

IDsearch-replace
SourceBuilt-in
Categorytext-processing
Cardinalitymonolingual
Tagsregex, configurable

Parameters

ParameterTypeDefaultDescription
dotAllbooleanfalseMake the period character match every character including line-feed
ignoreCasebooleanfalseIgnore case when matching search patterns
multiLinebooleanfalseMake ^ and $ match at the beginning and end of each line
regExbooleanfalseEnable regular expression mode for all search patterns
replaceAllbooleantrueReplace all matches instead of only the first
sourcebooleanfalsePerform search and replace on source content
targetbooleantruePerform search and replace on target content

Configure these parameters interactively and copy the flow-step YAML on the Tool Reference.

Examples

Replace a literal string in targets

Use literal matching on target text only.

target: true
ignoreCase: false

Case-insensitive regex over both scopes

Enable regex mode with case folding across source and target.

regEx: true
ignoreCase: true
source: true
target: true

Processing notes

  • Operates on translatable blocks only; non-translatable blocks pass through unchanged.

  • When neither source nor target is set, the tool applies to both for backward compatibility.

Limitations

  • Regular expressions use Go's RE2 syntax, which does not support backreferences or lookaround.

  • The search/replace pairs are supplied programmatically; only the matching options appear in the schema.

← Back to the Tool Reference