jq Filters and Transformations/Replace first regex match

Replace text using a regex pattern.

Section: Regex and Text Processing

Replace first regex match

bash
bash
echo '"hello world"' | jq 'sub("world"; "jq")'
Explanation

Use `sub()` for one replacement and `gsub()` for all matches.

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 Regex and Text Processing
Test regex match
Return true if a string matches a pattern.
OpenIn sheetbashsame section
Get regex match details
Return structured regex match metadata.
OpenIn sheetbashsame section
Capture named regex groups
Extract named groups into an object.
OpenIn sheetbashsame section
Replace all matches
Replace every instance of a pattern.
OpenIn sheetbashsame section
Split with regex
Split a string using a regex separator.
OpenIn sheetbashsame section
Logical AND
Filter items that satisfy two conditions.
OpenIn sheetbash1 tag match