Objects Commands

Work with JSON objects in jq. Learn property access, construction, and object transformation.

10 commands

Pro Tips

Use '{newKey: .oldKey}' to rename or restructure object properties.

Commands

Add key to object

$ cat file.json | jq '. + {newKey: "value"}'

Add new key-value pair to object

Delete key

$ cat file.json | jq 'del(.key)'

Remove key from object

Array to object

$ cat file.json | jq 'from_entries'

Convert key-value array to object

Merge objects

$ jq -s '.[0] * .[1]' file1.json file2.json

Deep merge two JSON objects

Get all paths

$ cat file.json | jq '[paths]'

Get all paths in JSON structure

Recursive descent

$ cat file.json | jq '.. | .name? // empty'

Find all name fields recursively

Rename key

$ cat file.json | jq '.newName = .oldName | del(.oldName)'

Rename object key

Object to array

$ cat file.json | jq 'to_entries'

Convert object to key-value array

Update key value

$ cat file.json | jq '.key = "new value"'

Update value of existing key

Transform object keys

$ cat file.json | jq 'with_entries(.key |= "prefix_" + .)'

Transform all object keys