# react-querybuilder/react-querybuilder

The Query Builder component for React

Repository: https://github.com/react-querybuilder/react-querybuilder
Canonical: https://ross.abutalabs.com/products/react-querybuilder
Homepage: https://react-querybuilder.js.org/
Language: TypeScript
License: MIT
License Family: permissive
Topics: react, query, custom, component, querybuilder, builder, query-builder, rule-builder, sql, mongodb
Last push: 2026-08-23T00:58:04+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 100
- inputs: {"age_days": 3729, "days_push": 11, "days_rel": 14, "gap_med": 6.0, "n_releases_24m": 57}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1724, forks 311 (observed 2026-08-28T04:05:28.003463+00:00)

## What it is
React Query Builder is a minimally opinionated, fully customizable React component for visually constructing queries from nested rules and rule groups, stored as a JSON query object. It ships with utility functions to import from and export to query languages such as SQL, MongoDB, JsonLogic, Elasticsearch, CEL, SpEL, LDAP, and ORM query objects, plus compatibility packages for UI frameworks like Ant Design, Bootstrap, and MUI.

## Use cases
- add a visual query builder to a react app
- let users build sql where clauses through a ui
- build a rule or filter builder for an admin dashboard
- convert a filter builder's json state into mongodb queries
- generate elasticsearch or jsonlogic queries from user-built filters
- build an advanced search filter ui in react
- parse sql where clauses into a structured query object

## When to choose
- you are building a React app and need a highly customizable query or filter builder UI with sensible defaults
- you need to translate user-built queries into SQL, MongoDB, ORM query objects, JsonLogic, Elasticsearch, CEL, SpEL, or LDAP
- you use a component library like Ant Design, Bootstrap, MUI, Chakra, or Bulma and want matching styled controls
- you want optional add-ons like drag-and-drop, enhanced date/time inputs, expressions, or an if-then-else rules engine

## When to avoid
- you need a query builder for Vue, Angular, or Svelte rather than React
- you need backend-only query parsing or validation with no visual component
- you need to execute queries against a database - this builds query representations, it does not run them

## Facets
- artifact type: library
- maturity: stable
- function: ui-components, parser, serialization
- domain: web-development, frontend
- platform: browser
- tags: react, query-builder, rule-builder, filter-builder, sql, mongodb, json-logic, elasticsearch, cel, ldap, typescript, admin-dashboards, no-code-query-ui, nodejs

## Member repositories
- react-querybuilder/react-querybuilder (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:28.003463+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:33:55.453556+00:00, confidence not recorded.
  - readme: https://github.com/react-querybuilder/react-querybuilder (fetched 2026-08-28T04:05:28.003463+00:00, sha b9a0a5e3618e)
  - homepage: https://react-querybuilder.js.org/ (fetched 2026-08-29T11:09:53.029537+00:00, sha 4f5baa8d4f18)
  - site_page: https://react-querybuilder.js.org/docs/4/intro (fetched 2026-08-29T11:09:53.049533+00:00, sha 3af4aef97c00)
  - site_page: https://react-querybuilder.js.org/docs/3/intro (fetched 2026-08-29T11:09:53.051367+00:00, sha f28a600acc36)
  - site_page: https://react-querybuilder.js.org/docs/utils/export (fetched 2026-08-29T11:09:53.053842+00:00, sha 4b203081f4ef)
  - site_page: https://react-querybuilder.js.org/docs/components/querybuilder (fetched 2026-08-29T11:09:53.039260+00:00, sha 0e018017e50d)
  - site_page: https://react-querybuilder.js.org/docs/intro (fetched 2026-08-29T11:09:53.042142+00:00, sha 5e2ecd31f4b2)
  - site_page: https://react-querybuilder.js.org/docs/next/intro (fetched 2026-08-29T11:09:53.044051+00:00, sha 3ffd0e15d841)
  - site_page: https://react-querybuilder.js.org/docs/6/intro (fetched 2026-08-29T11:09:53.045875+00:00, sha d29ead81eb65)
  - site_page: https://react-querybuilder.js.org/docs/5/intro (fetched 2026-08-29T11:09:53.047721+00:00, sha 72dfcca408a3)
- Data as of 2026-08-30T08:39:29.467469+00:00.