# wp-graphql/wp-graphql

:rocket: GraphQL API for WordPress

Repository: https://github.com/wp-graphql/wp-graphql
Canonical: https://ross.abutalabs.com/products/wp-graphql
Homepage: https://www.wpgraphql.com
Language: PHP
License: GPL-3.0
License Family: copyleft
Topics: graphql, wordpress, wp-plugin, graphql-server, wordpress-plugin, api, wpgraphql, graphql-api, graphql-php-library, hacktoberfest, gatsby
Last push: 2026-08-26T21:29:47+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 86, longevity 100
- inputs: {"age_days": 3593, "days_push": 7, "days_rel": 15, "gap_med": 4, "n_releases_24m": 74}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3791, forks 471 (observed 2026-08-28T04:08:18.792092+00:00)

## What it is
WPGraphQL is a free, open-source WordPress plugin that exposes an extendable GraphQL schema and API for any WordPress site. It lets developers query WordPress content (posts, pages, users, media, taxonomies) from modern frontend frameworks like Next.js, Gatsby, Vue, or Svelte.

## Use cases
- use wordpress as a headless cms with next.js
- query wordpress posts and pages via graphql
- replace the wordpress rest api with graphql
- build a gatsby site from wordpress content
- fetch nested wordpress data in a single request
- extend the wordpress api with custom graphql fields

## When to choose
- you want a decoupled/headless WordPress architecture with a modern JS frontend
- you need flexible, precise data fetching from WordPress instead of multiple REST round-trips
- you want an extendable GraphQL schema that plugins can build on

## When to avoid
- you only need simple REST endpoints and already have WP REST API integrations
- your stack is entirely server-rendered classic WordPress PHP themes
- you cannot install plugins on your WordPress host

## Facets
- artifact type: plugin
- maturity: active
- function: graphql, api-framework, http-server, middleware
- domain: web-development, cms, apis, backend
- platform: php, self-hosted
- tags: wordpress-plugin, headless-cms, decoupled-frontend, gatsby, nextjs, graphiql, web-server

## Member repositories
- wp-graphql/wp-graphql (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:18.792092+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-29T18:27:26.870769+00:00, confidence not recorded.
  - readme: https://github.com/wp-graphql/wp-graphql (fetched 2026-08-28T04:08:18.792092+00:00, sha 68b231588f94)
  - homepage: https://www.wpgraphql.com (fetched 2026-08-29T09:22:03.520153+00:00, sha 8f5b3cf8996e)
  - site_page: https://www.wpgraphql.com/docs/introduction (fetched 2026-08-29T09:22:03.522627+00:00, sha 99edc701193b)
- Data as of 2026-08-30T08:39:29.467469+00:00.