WPGraphQL for ACF

What is WPGraphQL for ACF?

WPGraphQL for ACF is a free, open-source WordPress plugin that connects Advanced Custom Fields (ACF) to the WPGraphQL schema. It lets you expose ACF fields to GraphQL, making them queryable by headless front ends. The plugin was created by Jason Bahl, a core contributor to the WPGraphQL ecosystem, and has been available for three years. It currently has 10K+ active installs and a 5.0/5 rating from 1 review, with 100% five-star feedback.

Version 2.6.4, last updated on Jun 30, 2026, continues to serve developers who need to query ACF fields with GraphQL. The plugin supports both ACF Free and Pro, plus most field types from ACF Extended. Its high rating reflects its reliability for headless WordPress projects.

Key Features of WPGraphQL for ACF

• ACF Field Group Configuration – Each field group and individual field can be toggled to “Show in GraphQL,” giving you granular control over schema exposure.
• Broad Field Type Support – Works with most built-in ACF field types (free and Pro) and extends support to ACF Extended field types.
• Flexible Content & Repeater Support – Pro-level fields like Flexible Content and Repeaters are fully queryable through the GraphQL endpoint.
• Options Page Integration – ACF Options Pages, a Pro feature, are added to the GraphQL schema for site-wide data queries.
• Local JSON & PHP Registration – Field groups can be registered via ACF’s UI, PHP code, or local JSON, all of which respect the GraphQL toggle.
• Semantic Versioning – The plugin follows Semver, with patch updates for bug fixes and minor versions for backward-compatible additions.
• Upgrade Guide for Major Updates – A dedicated upgrade path exists for users moving from v0.6.* or older, with staging-site recommendations for minor updates.

Who Should Use WPGraphQL for ACF?

This plugin is built for developers running headless WordPress sites with ACF. You should be comfortable with GraphQL queries and basic schema concepts. Typical users build front ends with Next.js, Gatsby, or other JavaScript frameworks. The plugin’s FAQ explicitly notes it works with any GraphQL client, including Apollo and Relay, not just Faust.js.

With 10K+ installs, the audience spans solo developers to agencies. Use cases include content-heavy sites that need to query ACF fields with GraphQL for dynamic layouts, or decoupled applications requiring structured data from ACF options pages. Beginners can use the ACF UI to toggle fields, but understanding GraphQL syntax is essential for querying.

Installation & Setup

Install WPGraphQL for ACF like any plugin from the WordPress repository. It requires WordPress 5.9+ and PHP 7.3+. The setup is beginner-friendly: after activating, create your ACF field groups and enable “Show in GraphQL” per group or field. The plugin automatically adds those fields to the GraphQL schema, so no manual configuration is needed.

Support & Community

Support data from the last two months shows 0 open threads and 0 resolved threads, with a 0% resolution rate. This likely reflects low support volume rather than poor service, given the plugin’s 100% five-star rating. The developer directs users to GitHub Discussions for general help, the WPGraphQL Discord for real-time chat, and GitHub Issues for bug reports.

The plugin’s rating of 5.0/5 from 1 review is backed by clear documentation and an active community. For developers learning how to use ACF with GraphQL in WordPress, the Discord server offers direct access to other users and contributors. The FAQ page also addresses common questions, such as the lack of built-in filtering by ACF fields, which is noted as a performance consideration.