WPGraphQL is a free, open-source WordPress plugin that provides an extendable GraphQL schema and API for any WordPress site.

First Steps

Are you new to using GraphQL with WordPress? This is the place to start!

Dig Deeper

Once you have the basics of WordPress and GraphQL down, you can dig deeper and learn more.

  • Advanced Guides: The following guides dive deep into specific concepts, philosophies and technical implementations of WPGraphQL.

    • Default Types and Fields: Learn about the default Types and Fields that WPGraphQL adds to the Schema based on registered post types, taxonomies and more.
    • WPGraphQL Request Lifecycle: Learn about how WPGraphQL executes queries and mutations and what happens under the hood.
    • Global ID: Learn about WPGraphQL’s use of a global ID for nodes
    • Connections: Edges? Nodes? Pagination? Huh? This guide will help you understand GraphQL connections and how/why WPGraphQL makes use of them.
    • Interfaces: WPGraphQL has many Interfaces that unlock some amazing potential. Learn more about what Interfaces are and specifically about how WPGraphQL makes use of them and how you can benefit from using them.
    • Performance: Learn how WPGraphQL works to keep execution fast and options for making things/keeping things fast when working with WPGraphQL.
    • Security: Learn how WPGraphQL works to keep your data secure and what you can do to keep things secure as you extend WPGraphQL with your own custom data.
    • Authentication and Authorization: Learn about Authentication and Authorization with WordPress and how they work with WPGraphQL.
    • Hierarchical Data: Learn about how to use WPGraphQL to interact with Hierarchical data, such as Nav Menus, hierarchical Post Types and hierarchical Taxonomies
    • GraphQL Resolvers: Learn about how GraphQL resolvers work in WPGraphQL and how to override their behavior.
    • Debugging: Learn common debugging techniques
  • Community: Connect with the community using WPGraphQL and get inspired by seeing how WPGraphQL is being used in the wild.

Developer Reference

This section contains technical reference for APIs and other aspects of WPGraphQL. They describe how it works and how to use it but assume you have a basic understanding of key concepts.

  • Actions: Actions are a type of WordPress “hook” that execute at certain points of a request. Learn about the actions WPGraphQL provides for developers to hook into.
  • Filters: Filters are a type of WordPress “hook” that allow developers to modify data during execution. Learn about the filters WPGraphQL provides for developers to hook into.
  • Functions: WPGraphQL provides many API functions for customizing the GraphQL Schema. Learn more about the available functions and how to use them to customize WPGraphQL.
  • Recipes: Recipes are bite-size morsels (aka code snippets) that can help satisfy your craving for productivity boosts when working with WPGraphQL.