Show what matched lines would look like after substitution.
Section: Replacement previews
Preview a simple replacement
bash
bash
rg --replace 'logger.error($1)' 'console\.error\((.*)\)' src/Explanation
This is a preview only; combine with `sd`, `perl`, or editor tools for actual rewrites.
Learn the surrounding workflow
Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.
Related commands
Same sheet · prioritizing Replacement previews
Use capture groups in replacements
Reuse matched text in the replacement output.
Print replaced fragments only
Combine `-o` and `--replace` to extract transformed matches.
Preview advanced regex replacements
Use PCRE2 pattern features with replacement preview.
Preview and select candidates interactively
Pipe results into a fuzzy finder before editing.
Disable line numbers for transformed output
Print cleaner replacement previews.