Run jq

How to use Run jq

1. 1. Paste your JSON. Put the JSON document you want to query into the input pane. This is the data your jq query will run against, just as if you had piped it into the jq command.
2. 2. Write your jq query. Enter a jq expression in the jq query field, such as .users[].name to pull a field out of every item in an array, or any other filter you would normally run on the command line.
3. 3. Adjust the output format. Turn on Compact output (-c) to get results on a single line instead of pretty-printed, and Raw strings (-r) to print string results without surrounding quotes.
4. 4. Copy the query result. Copy the output produced by your jq expression and use it wherever you needed the filtered or transformed data, without having jq installed locally.

When to use Run jq

Run jq lets you execute a jq query against a JSON document directly in the browser. It is for anywhere you need jq's filtering power, either because jq isn't installed, or you just want to try an expression quickly before committing it to a script.

• Extracting a field in CI without jq installed. A CI runner doesn't have jq available and installing it isn't worth the setup time for a one-off task. Run the query here and copy the result into the pipeline output.
• Testing a filter before adding it to a script. You want to confirm a jq expression produces the output you expect before hardcoding it into a bash script or Makefile that will run unattended.
• Reshaping a JSON export for a spreadsheet. An exported JSON file has nested data, and you need a flat list of specific fields to paste into a spreadsheet. A short jq query extracts exactly that.
• Debugging a jq expression from a forum answer. You found a jq one-liner in a Stack Overflow answer and want to check it actually does what it claims against your own JSON before trusting it in production.

Examples

{"users": [{"name": "Ada", "age": 36}, {"name": "Grace", "age": 45}]}

Query [.users[].name] returns:
"Ada"
"Grace"

About the Run jq tool

Frequently asked questions