PHPackages wp-graphql/wp-graphql - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. wp-graphql/wp-graphql ActiveWordpress-plugin[API Development](/categories/api) wp-graphql/wp-graphql ===================== GraphQL API for WordPress v2.6.0(4mo ago)3.8k391.7k↓25.6%468[40 issues](https://github.com/wp-graphql/wp-graphql/issues)[19 PRs](https://github.com/wp-graphql/wp-graphql/pulls)18GPL-3.0-or-laterPHPPHP ^7.4 || ^8.0CI passing Since Jan 12Pushed 1mo ago61 watchersCompare [ Source](https://github.com/wp-graphql/wp-graphql)[ Packagist](https://packagist.org/packages/wp-graphql/wp-graphql)[ RSS](/packages/wp-graphql-wp-graphql/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (17)Versions (244)Used By (18)Security (2) [![WPGraphQL Logo](./plugins/wp-graphql/img/logo.png)](./plugins/wp-graphql/img/logo.png) WPGraphQL Monorepo ================== [](#wpgraphql-monorepo) [![Total Downloads](https://camo.githubusercontent.com/f68b6a90ce01169885c88f66bcf2fd3834da02866ae8c2e4521ec836c58ccecd/68747470733a2f2f706f7365722e707567782e6f72672f77702d6772617068716c2f77702d6772617068716c2f646f776e6c6f616473)](https://packagist.org/packages/wp-graphql/wp-graphql)[![Monthly Downloads](https://camo.githubusercontent.com/bb4b6ee5086e86f15d0b1e894679bd1df88891eb053b247eeaca51bc0e93a3cb/68747470733a2f2f706f7365722e707567782e6f72672f77702d6772617068716c2f77702d6772617068716c2f642f6d6f6e74686c79)](https://packagist.org/packages/wp-graphql/wp-graphql)[![Daily Downloads](https://camo.githubusercontent.com/2f65fa88e692e355f77d607e8d71d31da5fbfd753375275ef93da393b1a66ac2/68747470733a2f2f706f7365722e707567782e6f72672f77702d6772617068716c2f77702d6772617068716c2f642f6461696c79)](https://packagist.org/packages/wp-graphql/wp-graphql)[![Latest Stable Version](https://camo.githubusercontent.com/7ada89a2a253fd46093d7a09425d66e291f6104aec62b3a4ac04454ee79fbae9/68747470733a2f2f706f7365722e707567782e6f72672f77702d6772617068716c2f77702d6772617068716c2f762f737461626c65)](https://packagist.org/packages/wp-graphql/wp-graphql)[![Testing Integration](https://github.com/wp-graphql/wp-graphql/workflows/Testing%20Integration/badge.svg)](https://github.com/wp-graphql/wp-graphql/actions?query=workflow%3A%22Testing+Integration%22)[![WordPress Coding Standards](https://github.com/wp-graphql/wp-graphql/workflows/WordPress%20Coding%20Standards/badge.svg)](https://github.com/wp-graphql/wp-graphql/actions?query=workflow%3A%22WordPress+Coding+Standards%22)[![Schema Linter](https://github.com/wp-graphql/wp-graphql/workflows/Schema%20Linter/badge.svg)](https://github.com/wp-graphql/wp-graphql/actions?query=workflow%3A%22Schema+Linter%22)[![GraphiQL E2E Tests](https://github.com/wp-graphql/wp-graphql/workflows/GraphiQL%20E2E%20Tests/badge.svg)](https://github.com/wp-graphql/wp-graphql/actions?query=workflow%3A%22GraphiQL+E2E+Tests%22)[![Code Quality](https://github.com/wp-graphql/wp-graphql/workflows/Code%20Quality/badge.svg)](https://github.com/wp-graphql/wp-graphql/actions?query=workflow%3A%22Code+Quality%22)[![codecov](https://camo.githubusercontent.com/53ce905461338b893fe568a9b87c5b81bc40db227a92c37cb3263b0d0be99c79/68747470733a2f2f636f6465636f762e696f2f67682f77702d6772617068716c2f77702d6772617068716c2f6272616e63682f6d61696e2f67726170682f62616467652e737667)](https://codecov.io/gh/wp-graphql/wp-graphql) **Unlock the power of WordPress data with GraphQL** WPGraphQL provides an extendable GraphQL API for any WordPress site, unlocking modern development workflows. Whether you're a WordPress developer exploring GraphQL or a GraphQL expert diving into WordPress, WPGraphQL simplifies data interaction and empowers your development workflow. --- ### 📁 **Repository Structure** [](#-repository-structure) This is a monorepo containing the WPGraphQL ecosystem of plugins and websites: ``` wp-graphql/ ├── plugins/ │ ├── wp-graphql/ # WPGraphQL core plugin │ ├── wp-graphql-ide/ # IDE extension plugin │ ├── wp-graphql-smart-cache/ # Smart Cache extension plugin │ └── wp-graphql-acf/ # ACF extension plugin ├── websites/ │ └── wpgraphql.com/ # WPGraphQL.com Next.js website ├── .wp-env.json # Shared WordPress environment config ├── package.json # Root workspace configuration └── turbo.json # Turborepo build orchestration ``` **For end users**: Nothing changes! Install WPGraphQL from WordPress.org, Composer, or download the release zip. **For contributors**: Clone the repo and run: ``` npm install # Install dependencies (uses workspaces) npm run wp-env start # Start WordPress environment with all plugins ``` 📚 See the [Development Guide](./docs/DEVELOPMENT.md) for detailed setup instructions. --- ### 🎯 **Vision** [](#-vision) WPGraphQL aims to be the **canonical GraphQL API for WordPress**, providing: - **A complete, flexible GraphQL schema** for accessing WordPress data - **Standards-based implementation** following GraphQL and WordPress best practices - **An extensible foundation** for plugins to build upon - **Production-ready performance** suitable for high-traffic sites - **Long-term stability** with semantic versioning and backward compatibility #### What Belongs in WPGraphQL Core? [](#what-belongs-in-wpgraphql-core) **In scope:** - GraphQL schema for WordPress core features (posts, pages, users, taxonomies, etc.) - Performance optimizations that benefit all users - Developer APIs for extending the schema - Standards and patterns for the WPGraphQL ecosystem **Candidates for core (via Experiments):** - Proposed features that need real-world validation before committing - Breaking changes that require community feedback - Performance improvements that need testing at scale - [Learn more about Experiments →](/docs/experiments) **Better as extensions:** - Plugin-specific integrations (ACF, Yoast, WooCommerce, etc.) - Opinionated workflows or conventions - Features specific to particular frameworks or use cases **The difference:** Experiments are potential core features being validated. Extensions are intentionally separate functionality that should remain as plugins. Experiments may graduate to core or be removed; extensions live independently forever. This focus keeps WPGraphQL maintainable while enabling a rich ecosystem of extensions. --- ### 🚀 **Get Started** [](#-get-started) 1. 📦 Install WPGraphQL: `wp plugin install wp-graphql --activate` 2. 👩‍💻 Try it out: [Live Demo](https://repl.wpgraphql.com) 3. 📖 Read the [Quick Start Guide](https://wpgraphql.com/docs/quick-start). 4. 💬 Join the [Community on Discord](https://wpgraphql.com/discord) 5. ⭐ [Star the Repo](https://github.com/wp-graphql/wp-graphql) on GitHub 😉 --- ### 🌟 **Key Features** [](#-key-features) - **Flexible API**: Access posts, pages, custom post types, taxonomies, users, and more. - **Extendable Schema**: Easily add functionality with functions like `register_graphql_field` and `register_graphql_connection`. - Plugins like [WPGraphQL Smart Cache](https://github.com/wp-graphql/wp-graphql/tree/main/plugins/wp-graphql-smart-cache), [WPGraphQL for ACF](https://github.com/wp-graphql/wp-graphql/tree/main/plugins/wp-graphql-acf) and [other extension plugins](https://wpgraphql.com/extensions) demonstrate the power of extendability. - **Modern Framework Integration**: Works seamlessly with [Next.js](https://vercel.com/guides/wordpress-with-vercel), [Svelte](https://www.okupter.com/blog/headless-wordpress-graphql-sveltekit), [Astro](https://docs.astro.build/en/guides/cms/wordpress/) and other frameworks. - **Optimized Performance**: Query only the data you need. Collect multiple resources in one request, reducing round-trips. Use [WPGraphQL Smart Cache](https://github.com/wp-graphql/wp-graphql/tree/main/plugins/wp-graphql-smart-cache) for enhanced performance and network-level caching and cache-invalidation. - **Developer Tools**: Explore the schema with tools like the [GraphiQL IDE](https://www.wpgraphql.com/docs/wp-graphiql) and [WordPress Playground](https://wordpress.org/plugins/wp-graphql/?preview=1). [![graphiql-ide-example.gif](plugins/wp-graphql/img/graphiql-ide-example.gif)](plugins/wp-graphql/img/graphiql-ide-example.gif) --- ### 📖 **Documentation** [](#-documentation) **For Users:** - [Quick Start](https://www.wpgraphql.com/docs/quick-start) - [Intro to GraphQL](https://wpgraphql.com/docs/intro-to-graphql) - [Intro to WordPress](https://wpgraphql.com/docs/intro-to-wordpress) - [Extensions](https://www.wpgraphql.com/extensions) - [Advanced Topics](https://www.wpgraphql.com/docs/wpgraphql-concepts) **For Contributors:** - [Development Setup](./docs/DEVELOPMENT.md) - Local environment setup - [Contributing Guide](./docs/CONTRIBUTING.md) - How to contribute - [Testing Guide](./docs/TESTING.md) - Running tests - [Architecture](./docs/ARCHITECTURE.md) - Codebase overview --- ### 🤝 **Community Support** [](#-community-support) WPGraphQL is powered by a passionate community of contributors, backers, and sponsors. [![](https://camo.githubusercontent.com/89c6a1a925b980675b55520f5f76f996aa121a8f419faee858280535db473b38/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f77702d6772617068716c2f636f6e7472696275746f72732e7376673f77696474683d38393026627574746f6e3d66616c7365)](https://github.com/wp-graphql/wp-graphql/graphs/contributors) [![Backers on Open Collective](https://camo.githubusercontent.com/cb90f33a988e5a071f6e3c28a3cf2a6397f21a5667bb3c013417dbe77eb916e9/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f77702d6772617068716c2f6261636b6572732f62616467652e737667)](https://opencollective.com/wp-graphql#backer) [![Sponsors on Open Collective](https://camo.githubusercontent.com/d249380ac057a05ae33369f3c4830a9e9c72622156bf6f37c98620a3f38a8e1b/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f77702d6772617068716c2f73706f6e736f72732f62616467652e737667)](https://opencollective.com/wp-graphql#sponsor) Want to help maintain and grow WPGraphQL? - [Support the project on Open Collective](https://opencollective.com/wp-graphql) - [Join the Community on Discord](https://wpgraphql.com/discord) - [Contribute to the project on GitHub](https://github.com/wp-graphql/wp-graphql) --- ### 🙌 Shout Outs [](#-shout-outs) We extend our gratitude to the following projects and organizations for their contributions to the WordPress and GraphQL ecosystems: - **[Webonyx](https://github.com/webonyx/graphql-php)**: For the amazing `graphql-php` library that powers WPGraphQL's core functionality. - **[Ivome](https://github.com/ivome/graphql-relay-php)**: For the `graphql-relay-php` library used in relay connections. - **[Automattic](https://automattic.com)**: For supporting WPGraphQL's ongoing development as a canonical WordPress plugin. - **[Gatsby](https://www.gatsbyjs.com)**: For their contributions to the WPGraphQL ecosystem and support for headless WordPress development. - **[WPEngine](https://wpengine.com)**: For funding early development of WPGraphQL and supporting its growth. - **[Facebook](https://graphql.org)**: For open-sourcing the GraphQL spec, GraphiQL, and maintaining the JavaScript reference implementation. - **[Apollo](https://www.apollographql.com)**: For pushing GraphQL forward and inspiring schema design best practices. - **The WordPress REST API Contributors**: For paving the way with the WP-API project, inspiring WPGraphQL's architecture. Thank you to all these organizations and individuals for their efforts in shaping the tools we rely on today. --- ### 🔌 **Canonical Plugin** [](#-canonical-plugin) WPGraphQL is becoming a [Canonical Plugin on WordPress.org](https://wordpress.org/news/2024/10/wpgraphql/), ensuring long-term support and a growing community of users and contributors. --- ### 🛠 **Privacy & Telemetry** [](#-privacy--telemetry) WPGraphQL uses the [Appsero SDK](https://appsero.com/privacy-policy) to collect telemetry data **only after user consent**, helping us improve the plugin responsibly. ### Health Score 74 — ExcellentBetter than 100% of packages Maintenance83 Actively maintained with recent releases Popularity65 Solid adoption and visibility Community47 Growing community involvement Maturity88 Battle-tested with a long release history Bus Factor1 Top contributor holds 69.6% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~13 days Total 239 Last Release 126d ago Major Versions v0.15.6 → v1.02020-11-16 v1.31.1 → v2.0.0-beta.12025-02-05 v1.32.1 → v2.0.02025-02-13 PHP version history (5 changes)v0.9.0PHP ^7.1||^8.0 v1.0.5PHP ^7 v1.2.0PHP >=7.1.0 v1.5.1PHP ^7.1 || ^8.0 v2.0.0-beta.1PHP ^7.4 || ^8.0 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1260765?v=4)[Jason Bahl](/maintainers/jasonbahl)[@jasonbahl](https://github.com/jasonbahl) --- Top Contributors [![jasonbahl](https://avatars.githubusercontent.com/u/1260765?v=4)](https://github.com/jasonbahl "jasonbahl (4906 commits)")[![justlevine](https://avatars.githubusercontent.com/u/29322304?v=4)](https://github.com/justlevine "justlevine (693 commits)")[![CodeProKid](https://avatars.githubusercontent.com/u/3899467?v=4)](https://github.com/CodeProKid "CodeProKid (215 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (194 commits)")[![markkelnar](https://avatars.githubusercontent.com/u/749603?v=4)](https://github.com/markkelnar "markkelnar (177 commits)")[![kidunot89](https://avatars.githubusercontent.com/u/13604318?v=4)](https://github.com/kidunot89 "kidunot89 (108 commits)")[![chriszarate](https://avatars.githubusercontent.com/u/739304?v=4)](https://github.com/chriszarate "chriszarate (95 commits)")[![hughdevore](https://avatars.githubusercontent.com/u/7156380?v=4)](https://github.com/hughdevore "hughdevore (91 commits)")[![mngi-arogers](https://avatars.githubusercontent.com/u/8104194?v=4)](https://github.com/mngi-arogers "mngi-arogers (87 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (70 commits)")[![josephfusco](https://avatars.githubusercontent.com/u/6676674?v=4)](https://github.com/josephfusco "josephfusco (62 commits)")[![esamattis](https://avatars.githubusercontent.com/u/225712?v=4)](https://github.com/esamattis "esamattis (56 commits)")[![blakewilson](https://avatars.githubusercontent.com/u/5946219?v=4)](https://github.com/blakewilson "blakewilson (34 commits)")[![renatonascalves](https://avatars.githubusercontent.com/u/19148962?v=4)](https://github.com/renatonascalves "renatonascalves (30 commits)")[![jacobarriola](https://avatars.githubusercontent.com/u/1371573?v=4)](https://github.com/jacobarriola "jacobarriola (29 commits)")[![moonmeister](https://avatars.githubusercontent.com/u/2730871?v=4)](https://github.com/moonmeister "moonmeister (25 commits)")[![t0lya](https://avatars.githubusercontent.com/u/46855519?v=4)](https://github.com/t0lya "t0lya (24 commits)")[![kellenmace](https://avatars.githubusercontent.com/u/5306336?v=4)](https://github.com/kellenmace "kellenmace (23 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (22 commits)")[![TylerBarnes](https://avatars.githubusercontent.com/u/14190743?v=4)](https://github.com/TylerBarnes "TylerBarnes (17 commits)") --- Tags apigatsbygraphqlgraphql-apigraphql-php-librarygraphql-serverhacktoberfestwordpresswordpress-pluginwp-pluginwpgraphql ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/wp-graphql-wp-graphql/health.svg) ``` [![Health](https://phpackages.com/badges/wp-graphql-wp-graphql/health.svg)](https://phpackages.com/packages/wp-graphql-wp-graphql) ``` ### Alternatives [nuwave/lighthouse A framework for serving GraphQL from Laravel 3.5k10.7M93](/packages/nuwave-lighthouse)[thecodingmachine/graphqlite Write your GraphQL queries in simple to write controllers (using webonyx/graphql-php). 5723.1M30](/packages/thecodingmachine-graphqlite)[overblog/graphql-bundle This bundle provides tools to build a GraphQL server in your Symfony App. 8027.9M28](/packages/overblog-graphql-bundle)[wheelpros/fitment-platform-api Magento 2 (Open Source) 12.1k1.2k](/packages/wheelpros-fitment-platform-api)[aimeos/ai-admin-graphql Aimeos Admin GraphQL API extension 944100.0k4](/packages/aimeos-ai-admin-graphql)[mll-lab/graphql-php-scalars A collection of custom scalar types for usage with https://github.com/webonyx/graphql-php 1394.2M28](/packages/mll-lab-graphql-php-scalars) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)