Deferred Resolvers

One of the most frustrating problems with data fetching is a so-called "N+1 problem". Consider the following GraphQL Query:

  posts(first:10) {
    nodes {
      author {

Naive field resolution process would query once for the 10 posts, then make 10 more calls to get the author for each author of each of the 10 posts. (get me author for post 1, get me author for post 2, and so on)

The GraphQL-PHP library under WPGraphQL provides tools to mitigate this problem by allowing you to defer actual field resolution to a later stage when one batched query could be executed instead of 10 distinct queries.

How does deferred resolving work?

Instead of resolving a field immediately, part of the data will be added to a cache for execution later.

In the case above, we are querying for a list of posts, and on each post we have a post_author attribute which is the ID of the User that authored the post.

Instead of querying for the Author immediately, we cache the user ID, and once all posts have been resolved, GraphQL comes back and executes a single WP_User_Query to get all users connected to all of the posts, then returns the data in the field resolver.

You can read more about how GraphQL-PHP handles this here.

Deferred Resolvers in WPGraphQL

In v0.3.0 of WPGraphQL, Deferred resolution was implemented across the codebase and centralized in a way that makes it easy for extending plugins to take advantage of.

You can read more about it here.