Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

jq

jqlang.org

  • Free plan
  • Windows
  • macOS
  • Linux
  • Web
  • Self-hosted
8.3 Club score Visit jqlang.org

What jq is

jq is a free command-line tool for filtering and transforming JSON data. A jq filter takes an input value and produces output; filters can be combined to select data, access nested attributes, construct objects or gather results into arrays. Each expression runs on each input value and can produce zero or more outputs. jq reads whitespace-separated JSON values and writes serialized results, allowing streams of values to be joined together. For very large inputs, its --stream option parses incrementally. Output controls include compact, raw, ASCII, sorted-key and colored forms. jq is implemented in portable C and has no runtime dependencies; a binary can be copied to another machine of the same type. Standalone executables are available for Linux, macOS and Windows, with packages also listed for Linux distributions and package managers. A Docker image is available as well. Release binaries have SHA-256 checksums, and signed release artifacts use jq release keys. The code is MIT-licensed, while its documentation is licensed under CC-BY-3.0.

Who it suits

jq suits developers and administrators who need to query, filter or transform JSON from the command line. Its incremental parsing option is useful for very large inputs.

Good to know, and what to watch

  • Filters can be combined to transform JSON values.
  • --stream parses large inputs incrementally.
  • Portable C implementation has no runtime dependencies.
  • Standalone executables are available for Linux, macOS and Windows.
  • Release binaries have SHA-256 checksums.
  • It is a command-line tool, not a graphical JSON editor.
  • A copied binary runs on another machine of the same type.

jq

Free

Free plan

Getting started

  1. Visit the jq project website
  2. Install a standalone executable for Linux, macOS, or Windows
  3. Alternatively install jq through a listed package manager
  4. Use the Docker image from GitHub Container Registry
  5. Build from source on a POSIX-like operating system if needed
  6. Verify downloaded binaries with the provided SHA-256 checksums

Limits to check

For very large inputs, use --stream to parse incrementally. jq emits JSON values as whitespace-separated serialized stream output.

The Club's review

jq is a compact command-line tool for querying and reshaping JSON. It suits developers, data engineers and administrators who are comfortable composing terminal commands or embedding them in scripts. Its dependency-free binary and streaming mode make it a particularly sensible choice when portability and large-input processing matter more than a graphical interface.

Overview

jq treats JSON processing as a stream operation rather than a one-document-only task. It accepts whitespace-separated JSON values, applies an expression to each value and emits newline-separated results. An expression may produce no result, one result or several, which is useful when selecting matching records or expanding nested data.

The core abstraction is a filter: a program receives input and produces output, and filters can be chained into a larger transformation. That model supports selecting fields, reaching into nested attributes, constructing objects and collecting values into arrays. It covers both everyday querying and repeatable batch transformations without requiring a separate scripting runtime.

Written in portable C with zero runtime dependencies, jq can be moved as a single binary between machines of the same type. That makes deployment unusually straightforward for shell scripts, build jobs and self-hosted environments. The trade-off is that users must learn a filter language and work in a terminal; jq is not a visual JSON editor or a guided desktop workflow.

Key features

Composable filters

jq's filter model is its main strength. Operations can be combined so a command first selects relevant data, then reshapes it or gathers it into a new structure. This is more expressive than repeatedly opening a file and editing fields, and it scales well to scripted, repeatable work. The same model can be demanding for newcomers who want point-and-click inspection.

Streaming and large inputs

Normal processing handles a stream of JSON values, with each expression evaluated against each input. The --stream option parses incrementally, reducing the need to hold a very large input in memory at once. It is the feature that most clearly favors jq over lightweight viewers when logs, exports or batches become too large for comfortable interactive handling.

Output control

Options produce compact, raw, ASCII, sorted-key or colored output. These choices matter in practice: compact output is convenient for transport, raw output fits shell pipelines, sorted keys help stable comparisons, and color improves terminal inspection. They also let one processor serve both human-readable diagnostics and machine-oriented jobs.

Portable distribution and assurance

Standalone executables are provided for Linux, macOS and Windows, while packages are available through major Linux repositories and tools including Homebrew, MacPorts, Fink, winget, Scoop and Chocolatey. A Docker image is published through GitHub Container Registry, and source builds support Linux, macOS, Cygwin and other POSIX-like systems. SHA-256 checksums and signed release artifacts support verification, with private vulnerability disclosure enabled for the project repository.

Pricing

jq is free software under the MIT license, with documentation under CC-BY-3.0. The jq plan costs free and includes MIT-licensed software plus standalone binaries for Linux, macOS and Windows. There is no trial because the product is already free, and no seat, usage or renewal charge is stated. This is the right fit for individual users, teams and self-hosted deployments that want a capable JSON processor without a subscription; it gives up the commercial support and graphical experience found in some paid alternatives.

Platforms

jq supports Linux, macOS, Windows, web and self-hosted use. The official standalone executables cover the three desktop operating systems, while repository packages, a container image and source builds broaden deployment options. Its documented capabilities include schema validation, JSON querying and batch processing. The web and self-hosted labels make it adaptable to hosted or controlled environments, but the primary interaction remains command-line oriented.

Who it's for

Choose jq if you routinely inspect API responses, reshape configuration data, process logs or automate JSON transformations in scripts and pipelines. It is especially well suited to engineers who value a small, portable executable and need incremental parsing for very large inputs. It is less suitable for occasional users who expect a visual tree, editing controls or a guided interface, and for teams that require a paid support contract or a managed service.

Pros and cons

Pros

  • Composable filter language: querying and transformation can be expressed as reusable pipelines rather than ad hoc edits.
  • Streaming option: --stream supports incremental parsing for very large inputs.
  • Minimal deployment: portable C and zero runtime dependencies make a copied binary practical in scripts and restricted hosts.
  • Flexible output: compact, raw, ASCII, sorted-key and colored modes suit both automation and terminal reading.
  • Broad distribution: native executables, package managers, containers and source builds cover common operating models.

Cons

  • Terminal-first workflow: users who need visual navigation or editing must look elsewhere.
  • Filter-language learning: advanced transformations require comfort with jq expressions rather than simple form controls.
  • No paid service tier: organizations seeking contractual support or a managed product do not get that option from jq itself.

Alternatives

For a graphical Windows JSON environment with a free perpetual personal or educational license, JSONBuddy is the more natural choice. JSONZen suits browser users who want share links and snippets, with a free tier and a paid 30-day option. BracketView is preferable when web access, encrypted snapshots, uploads and bounded AI or webhook actions are central. Dadroit JSON Viewer fits users wanting a visual viewer and conversion to CSV or XML, including files up to 50 MB on its free non-commercial plan. JSON OS is a browser-based editor with Markdown preview. jsonfmt.dev is aimed at API callers who need published request quotas and endpoint access. gojq is the closest alternative for a free, MIT-licensed CLI that also offers a Go library. jless is a focused free command-line viewer for macOS and Linux rather than a general transformation engine.

For broader discovery, see the JSON Tools and Data Transformation Tools lists.

Verdict

jq is the right choice for technically confident users who need dependable JSON querying and transformation in scripts, pipelines or self-hosted systems. Its strongest reasons to choose it are the composable filter model, incremental handling of huge inputs and genuinely portable free distribution. Look elsewhere when a graphical editor, browser-first collaboration or commercial support matters more than command-line control.

The verdict

jq offers a focused way to process JSON through composable command-line filters, with options for large inputs and multiple output styles. It is a practical fit for users comfortable working in a terminal.

Questions people ask

How much does jq cost?

jq is free. The listed jq plan costs nothing.

Which platforms have official jq executables?

Official standalone executables are available for Linux, macOS, and Windows.

Can jq process very large JSON inputs?

Yes. Its --stream option parses input incrementally and is intended for very large inputs.

What licenses does jq use?

The jq code is licensed under MIT. Its documentation is licensed under CC-BY-3.0.

Where can jq be installed?

Packages are listed for several Linux distributions and package managers, including Homebrew, MacPorts, Fink, winget, Scoop, and Chocolatey. A Docker image and source builds are also available.

What the maker publishes

Artifact verification
Release binaries have SHA-256 checksums and signed release artifacts with jq release keys. source
Binary portability
A single jq binary can be copied to another machine of the same type and run. source
Container
A jq Docker image is available from GitHub Container Registry. source
Container
A Docker image is available from GitHub Container Registry. source
Data handling
jq processes streams of JSON values, with each expression running on each input value and producing zero or more outputs. source
Data operations
jq can slice, filter, map and transform JSON data. source
Desktop platforms
Official standalone executables are available for Linux, macOS and Windows. source
Distribution
The download page lists installation through Linux distribution repositories, Homebrew, MacPorts, Fink, winget, Scoop, and Chocolatey. source
Filter model
A jq program is a filter that takes an input and produces an output, and filters can be combined. source
Implementation
jq is written in portable C and has zero runtime dependencies. source
Implementation
jq is written in portable C and has zero runtime dependencies. source
Large inputs
The --stream option parses input incrementally and is useful for very large inputs. source
License
jq code is licensed under the MIT license, while its documentation is licensed under CC-BY-3.0. source
Licensing
jq code is licensed under MIT and its documentation under CC-BY-3.0. source
Maintainers
The jqlang organization says it is the canonical source for the C implementation of jq and that new maintainers were recruited. source
Output controls
jq provides options for compact, raw, ASCII, sorted-key and colored output. source
Output format
JSON values in jq streams are serialized with whitespace separators, so streams can be joined together. source
Package integrations
jq is available through Debian, Ubuntu, Fedora, openSUSE, Arch, Homebrew, MacPorts, Fink, winget, Scoop and Chocolatey. source
Platforms
The download page links standalone executables for Linux, macOS, and Windows, and describes building jq for nearly any platform. source
Purpose
jq is a lightweight and flexible command-line JSON processor. source
Purpose
jq is a lightweight, flexible command-line JSON processor for slicing, filtering, mapping, and transforming structured data. source
Release
The project news page lists jq 1.8.2 as released on June 20, 2026. source
Security
SHA-256 checksums are provided for release and pre-release binaries, and release artifacts are signed by a jq release key. source
Security reporting
The jqlang/jq repository has GitHub private vulnerability disclosure enabled. source

Checked against the maker's pages on 2 Oct 2026.