Overview
WPGraphQL for ACF describes itself as: “WPGraphQL for ACF seamlessly integrates Advanced Custom Fields with WPGraphQL.”
It is active on 10,000+ WordPress sites and rated 5.0 out of 5 by 1 users on WordPress.org. Developers can extend it through 5 actions and 19 filters, listed below.
How to install WPGraphQL for ACF
- Open the plugin installer. In your WordPress dashboard go to Plugins → Add New Plugin.
- Search for it. Type “WPGraphQL for ACF” and pick the one by Jason Bahl.
- Install and activate. Click Install Now, then Activate.
Install with a zip file or WP-CLI
Download the zip from the WordPress.org plugin page, then go to Plugins → Add New Plugin → Upload Plugin, choose the file and click Install Now. Or from the command line:
wp plugin install wpgraphql-acf --activateRequirements: WordPress 5.9+ · PHP 7.3+ · tested up to WordPress 7.0.8
Hooks & customisation
WPGraphQL for ACF 3.2.1 fires 5 actions and 19 filters. Use them from your child theme or a snippets plugin to change how it behaves without editing its files.
// Filter the config before setting it on the class
apply_filters( 'wpgraphql/acf/field_type_config', $_config, $this );
// If external code has filtered this to return anything other than null, use the…
apply_filters( 'wpgraphql/acf/field_type_resolve_type', null, $field_config, $acf_field );
// If external code has filtered this to return anything other than null, use the…
apply_filters( 'wpgraphql/acf/field_type_resolver', … );
// Filter the value before returning
apply_filters( 'wpgraphql/acf/field_value', $prepared_value, $field_config, $root, $node_id );
// Filter the graphql_field_config for an ACF Field
apply_filters( 'wpgraphql/acf/get_graphql_field_config', $field_config, $this );
// If a value is returned from this filter,
apply_filters( 'wpgraphql/acf/pre_get_node_acf_id', null, $node );Need WPGraphQL for ACF customised?
Tell us what you want changed, added or fixed and we'll reply with an estimate.
WP EXPERTS is independent and not affiliated with Jason Bahl. Plugin names and logos belong to their owners. Version, rating and install figures from WordPress.org, checked Nov 17, 2026.