NEW! WPGraphQL for Advanced Custom Fields

Interact with ACF Field data using GraphQL Queries

WPGraphQL for Advanced Custom Fields

Interact with your Advanced Custom Field data using GraphQL Queries

Play Video

How it Works

WPGraphQL for Advanced Custom Fields automatically exposes your ACF fields to the WPGraphQL Schema

Create your ACF Fields

Create your ACF Field Groups and Fields, the same way you normally would, using the ACF User Interface, registering your fields with PHP or using ACF local-json. Each field group and the fields within it can be configured to "Show in GraphQL".

Query with GraphQL

Once your field groups and fields have been configured to "Show in GraphQL", they will be available in the GraphQL Schema and ready for querying!

Supported ACF Fields

  • Text
  • Text Area
  • Number
  • Range
  • Email
  • URL
  • Password
  • Image
  • File
  • WYSIWYG
  • oEmbed
  • Select
  • Checkbox
  • Radio Button
  • Button Group
  • True False
  • Link
  • Post Object
  • Page Link
  • Relationship
  • Taxonomy
  • User
  • Google Map
  • Date Picker
  • Date/Time Picker
  • Time Picker
  • Color Picker
  • Group
  • Repeater
  • Flex Field
  • Gallery

WPGraphQL for Advanced Custom Fields supports nearly all of the ACF (free & pro) fields. Some of the fields, such as Accordion and Tab, which are not data fields are not supported. The Clone field needs some more assessment to determine if it can properly be supported. Fields from 3rd party extensions are not supported out of the box, but we are interested in supporting the popular ones.

Why WPGraphQL for ACF?

Time

WPGraphQL is highly extendable, but it can be time consuming to expose fields to the Schema. This plugin can save you heaps of time.

Performance

WPGraphQL is one of the fastest ways to query data in WordPress, and now we bring that performance to ACF data too.

Support

On top of the great WPGraphQL community support already available, we offer plugin support through email, forums, and code sharing.

Works Great with Popular JavaScript Libraries

WPGraphQL for Advanced Custom Fields allows you to truly separate your concerns between WordPress and your JavaScript application. The components of your application can manage their data dependencies by specifying the exact fields needed, reducing the load on the server to process and minimizing the data downloaded by your application.

Pricing & Support

WPGraphQL for Advanced Custom Fields is a FREE open-source WordPress plugin. 
The code is available on Github. Support and feature requests are handled through Github issues. For general questions about the plugin, visit the WPGraphQL Slack (join here) or the WPGraphQL Spectrum community.

FAQ

Support is limited to usage of the WPGraphQL for Advanced Custom Fields.

If you need support for things such as learning best practices of implementing GraphQL at your organization, expert advice/consulting on a specific project(s), learning how to use WPGraphQL with caching clients, such as Apollo, or other needs not directly related to this plugin, contact us and we can pair you with an expert.  

Support and feature requests are handled through Github issues. For general questions about the plugin, visit the WPGraphQL Slack (join here) or the WPGraphQL Spectrum community.

Some ACF Field locations are very difficult to map to a GraphQL Schema. While we are working on supporting additional location rules, some highly contextual rules (such as assigning a Field Group to a particular page based on it’s parent) are difficult to support. This is because the GraphQL Schema is independant of content in the WordPress site, but is representative of possible Types in the WordPress site.

Support is provided for ACF Field Groups assigned to entire Post Types or Taxonomies, Users, Comments and Menu Items.

Additional location support is being added regularly based on demand.

WPGraphQL for Advanced Custom Fields does not currently support mutations of ACF Fields. Mutation support will be added to future versions of this product if there is a strong enough community for it.

WPGraphQL for Advanced Custom Fields requires Advanced Custom Fields (free or pro) and WPGraphQL v0.3.2 or newer.

Still have questions?

If you still have questions about the plugin and want to learn more, let us know and we’d be glad to chat.