WPGraphQL for ACF
WPGraphQL for Advanced Custom Fields is a free, open-source WordPress plugin that adds ACF Fields and Field Groups to the WPGraphQL Schema. Create ACF Field Groups Create ACF Field Groups and Fields using the ACF User Interface, register them with PHP, or leverage ACF local JSON. Each field group an
About this tool.
WPGraphQL for Advanced Custom Fields is a free, open-source WordPress plugin that adds ACF Fields and Field Groups to the WPGraphQL Schema.
Create ACF Field Groups
Create ACF Field Groups and Fields using the ACF User Interface, register them with PHP, or leverage ACF local JSON. Each field group and the fields within it can be configured to “Show in GraphQL.”
Query your fields with GraphQL
Once your field groups and fields are configured to “Show in GraphQL,” they become available in the GraphQL Schema for querying.
Supported Field Types
WPGraphQL for ACF provides support for most built-in field types of ACF (free & PRO) and extends support to most field types from ACF Extended (free & PRO).
Updating
If you are updating from WPGraphQL for ACF v0.6.* or older, check out the Upgrade Guide
For non-major version updates, automatic updates usually should work smoothly, but we still recommend you back up your site and test on a staging site.
Before updating WPGraphQL for ACF, review the release notes on GitHub .
We follow Semantic Versioning (Semver) for meaningful releases:
- MAJOR version for incompatible API changes,
- MINOR version for backwards-compatible functionality additions,
- PATCH version for backwards-compatible bug fixes.
Learn more about Semver at semver.org .
Support
- General Help Requests : For general questions and help requests, create a new topic in Github Discussions
- Discord Community : The WPGraphQL Discord is a great place to communicate in real-time. Ask questions, discuss features, get to know other folks using WPGraphQL.
- Bug Reports : Report a bug in WPGraphQL
- Feature Requests : Suggest an idea, feature, or enhancement for WPGraphQL.
- Report a Security Vulnerability : Report a security vulnerability.
FAQs
Does this work with ACF Extended?
Yes! WPGraphQL for ACF allows you to query for (most) fields created with ACF Extended.
Can I filter and sort queries by ACF Fields using WPGraphQL for ACF?
At this time WPGraphQL for ACF does not support filtering or sorting queries by ACF Fields. “Meta Queries” are often very expensive to execute, so we currently do not support filtering by ACF fields out of the box, but are exploring options for supporting it without the performance penalty.